rae Official 








RASPBERRY PI 
BEGINNERS BOOK 





Ma Ki 


LEARN | CODE | MAKE 






a Ni hax ‘90 













= = 


N69 oo 


= 
of ie nT0 
CAMERA N70! FF af 


CS Fy ine) ls Tc 
| Ane CRAFT! \TCH :o —— 
=== HE oR a poerry Pi Cee! 


17 wi iT Bat ti, OL | 


»~ Google Play 

























® From the makers of the GET oa 
Mad? | official Raspberry Pimagazine | )[(3//A 








FREE KIT NOT INCLUDED with sisital eaition 





WELCOME TO 
THE OFFICIAL 
RASPBERRY PI 
BEGINNER'S BOOK 


ou are holding, in your hands, a piece of history. 
The Official Raspberry Pi Beginner’s Book isn’t just 
a book about a computer: It’s a book with a computer. 

Not just any computer either. The Pi Zero W is an 
incredibly well-designed microcomputer. And it’s the most 
creative programmable computer on earth. 

With a Raspberry Pi, you can hack, make and build all 
kinds of different things. It could be a digital camera, or a 
retro games console, or a home media centre. Or a sensor on 
board the International Space Station, or a programmable 
Minecraft machine. 

Everything you need to get started with a Raspberry Pi RASPBERRY PI 
computer is inside this kit. 

Our tutorials will guide you, step-by-step, from setting up 
the Pi Zero W hardware to learning how to use the Raspbian 
operating system, through to hacking electronics with the 
GPIO pins on your Pi Zero W. 

You’ ll also learn how to program a computer with Python, 
the world’s best programming language. We show coding 
the fun way, by hacking worlds in Minecraft and making your 
own games. 

We’re so glad you’ve got The Official Raspberry Pi 
Beginner’s Book. Now let’s get started... 








MOO" S. HANNIOSG Id AMMARASVS TWIO1LsA9 SAL 
| 
| 





The pocket-sized desktop computer! __— 
P] ZERO 


Lucy Hattersley 
Editor 





SIN MUSMO MIs CaSpberrypi.org/magpi [cejamwtlfeeg magpi@raspberrypi.org 










The e EDITORIAL DESIGN PUBLISHING 
Mad? Publishing Director: Russell Barnes Critical Media: criticalmedia.co.uk For advertising & licensing: 
Editor: Lucy Hattersley Head of Design: Dougal Matthews russell@raspberrypi.org 
Features Editor: Rob Zwetsloot Designers: Lee Allen, Daiva Bumelyte, Comms Director: Liz Upton 
4 Available on the Sub Editors: Phil King, Jem Roberts and Mike Kay CEO: Eben Upton 
ltustrator: Sam Alder 
DISTRIBUTION MAGAZINE SUBSCRIPTIONS CONTRIBUTORS 
Seymour Distribution Ltd Select Publisher Services Ltd Phil King, Laura Sach, 
2 East Poultry Ave PO Box 6337 Marc Scott, K.G. Orphanides, 
(c) @) & (0) London Bournemouth and Clive Webster 
BY _NC_ SA EC1A 9PT | +44 (0)207 429 4000 BH19QEH | +44 (0)1202 586 848 
This bookazine is printed on paper sourced from This official product is published by Raspberry Pi (Trading) Ltd., Station Road, Cambridge, CB1 2JH. The publisher, editor and 
font sustainable forests and the printer operates an contributors accept no responsibility in respect of any omissions or errors relating to goods, products or services referred 
environmental management system which has to or advertised in the magazine. Except where otherwise noted, content in this magazine is licensed under a Creative 
been assessed as conforming to ISO 14001. Commons Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0). ISBN: 978-1-912047-70-3. 


raspberrypi.org/magpl The Official Raspberry Pi Beginner's Book eS 3 








06 GETTING STARTED 
Plug in and set up your Raspberry Pi 


22 BEGINNER’S GUIDE TO NOOBS 
Install the Raspbian OS with NOOBS 


24 CREATE SD CARDS WITH ETCHER 
Use Etcher to install an image file 


26 THE CONFIGURATION TOOL 
Adjust the settings in Raspbian 


28 MAKE A MEDIA CENTRE 
Create a home theatre system 


30 BEGINNER’S GUIDE TO VNC 

Remote-control the Pi from another computer 
32 THE Pl CAMERA 

Attach a camera to your Raspberry Pi 


34 SWITCH TO THE COMMAND LINE 
Work faster and smarter 


40 BEGINNER'S GUIDE TO SSH 

Access the command line remotely 
42 GPIO ZERO 

Control the pins on your Raspberry Pi 


46 HOW TO USE A BREADBOARD 
Prototype circuits 


48 CODE IN PYTHON WITH THONNY 
Discover Thonny, a Python coding tool 


50 SET UP A FILE SERVER 
Save and share files on a home network 


GETTING STARTED WITH YOUR PI ZERO W 
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52 BUILD A WEB SERVER 
Share webpages on a local network 


54 BACK UP YOUR RASPBERRY PI 
Keep your files safe with a backup 


56 POWER YOUR RASPBERRY PI 
Discover the power options 


58 GET HELP FROM THE COMMAND LINE 
Find help for command-line tools 


62 MINECRAFT PI 
Start using Minecraft on your Raspberry Pi 


64 MINECRAFT PI CODING TIPS 
Hack and code Minecraft with your Pi 


68 MINECRAFT PI TIPS & TRICKS 
Expert tips and coding tricks for Minecraft Pi 


72 BEGINNER'S GUIDE TO CODING 
The rough guide to Python ona Pi 


86 UNDERSTAND OBJECT-ORIENTED CODING 
Discover this popular style of programming 


96 CODE WITH GIT 
The tool used by developers everywhere 


102 SENSE HAT EMULATOR 
Simulate the Pi hardware used in space 


104 INSIDE THE PI ZERO W 
Behind the scenes with the team who bullt it 
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CREATE SD CARDS WITH ETCHER 


SELECT IMAGE SELECT DRIVE 
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FQUIPMEN I 





The microSD card in your kit acts as the hard drive for 
your Raspberry Pi. You install the Raspbian operating 
system onto the card, then all your documents, 

files, and projects are saved to it as you work. The 
microSD card in your Starter Kit is a high-quality piece 
of equipment and comes with NOOBS pre-installed. 

If you want to use a larger card, and are wondering 
which brand and type to get, take a look at the results 
from benchmark tests done by Raspberry Pi fan Jeff 
Geerling. Some cards run up to four times as fast as 
others. You can read more at magpi.cc/2bncFs3. 
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Welcome to the Claws Mail setup wizard 


We will begin by defining some basic information about you 
and your most Common mail options so that you can start 


Pre Shared Key | 


Cancel OK 
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Devices connected 
by Bluetooth work 
wirelessly with your 
Raspberry Pi 





Start by putting your Bluetooth device 
in Pairing 7 Discoverable mode. We're 
using an Apple wireless keyboard 
here. Hold down the power button 
until the LED flashes. Click Bluetooth 
in the Panel and choose Add Device. 


Tum Off Bluetooth 


Make Discoverable 





The Add New Device window opens 
and will scan for nearby Bluetooth 
devices. Some will have names, 

others just identifying numbers (check 


on the device). Choose a device from 
the list and click Pair. 









Searching for Bluetooth devices. 


@) 45-97-84.09-22-F5 


@© 00-03-48-18.40.42 
@) 42-10-0F-96-96-1€ 








Care! 


The Pi now attempts to pair with the 
Bluetooth device. You'll be asked to 
enter a code on the keyboard; press 
the buttons and RETURN. You can 
now start using the Bluetooth device 
with your Raspberry Pi. 







Please confirm that device ‘Lucy's MacBook Pro’ 
is showing the code 776706 to connect 


OK 
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micro SD card 
(8GB or larger) 


/ NOOBS 
installation files Ss 
, | Your starter kit micro SD card is already 


Mac, PC or set-up with NOOBS and ready to use 


Linux machine 





Click the Install button 
Ko co) daat-im\(oll mani gem) BD) 
card and install the selected 
operating system 
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of operating systems 
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The easiest way to set up a Raspberry Pi with Raspbian, 
and other operating systems, is to use the NOOBS installer 
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QQ) Paspbian (RECOMMENDED) 
\ A port of Debian Stretch for the Raspberry Pi (ful desktop version) 
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Burn. Better. 


Burn images to SD cards & USB drives, safe & easy. 
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¥ Flash Complete! 
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BEGINNER'S GUIDE 










> Raspberry Pi 





 Raspbian Jessie 
with PIXEL 


Password: Change Password... 
Hostname: raspberrypi 


Boot: © To Desktop © To CLI 














Auto Login: As current user 









Network at Boot: _) Wait for network 
Splash Screen: O Enabled ©) Disabled 









Resolution: Set Resolution... 


Underscan: @) Enabled © Disabled 
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Options to expand the file system and change password 
and hostname sit alongside various login choices. 


Support for the various hardware and software 
features, such as Camera Module, SSH, and VNC. 


Overclocking and GPU memory options can improve 
the performance of a Raspberry Pi. 


Set up an international keyboard, global WiFi options, 
and adjust the locale and time zone. 























Raspberry Pi Configuration = x 


System nterfaces | Performance | Localisation 


SSH ®) Enabled sable 
IC ®) Enabled Disabled 

SP enabled 
or Fnablec / ®) Disabled 
Seria Fnabled ® Disabled 
-Wire Enabled *) Disabled 
Remote GPIC Enabled ©) Disabled 
Cance OK 








Performance 





nterfaces Localisation 
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System interfaces Performance | Locelisat Country Variant 














Build your home theatre media centre with a Raspberry Pi and OSMC 


uilding a media centre, or HIPC (home 
theatre PC) is one of the most rewarding 
projects a newcomer can complete. 

It’s easy to turn a Raspberry Pi into an HTPC, and 
you can quickly hook it up to your television. 

Using an HTPC, you can play video and music files, 
and stream video and audio from online services. And 
unlike proprietary systems, such as Apple TV and 
Google Chromecast, you can use it to play just about 
any media format. 

You can add streaming services to your HTPC, such 
as BBC iPlayer and Soma radio stations. These enable 
you to play media directly from the internet. 

There are several pieces of software available for 
setting up an HTPC. Two options you’ ll find on the 
Raspberry Pi Foundation’s Downloads page are OSMC 
and LibreELEC. Both are similar and run a media © = @ 


SELECT IMAGE SELECT ORIVE FLASH IMAGE 


player called Kodi. O O O 
In this guide, we’re going to opt for OSMC. It’s a 


free and open-source media centre built on top of 
Debian, and is reliable and easy to use. 

Setting up OSMC on a Raspberry Pi is are 
a Straightforward and rewarding project. 
Let’s get started. 
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OSMC_TGT_...24.img.gz © idevisdb - 7.9 GB 
63% 
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Keturn of the Kung Fu Dragos: Free Download & Streaming: incemect Archive - Mozilla trefox 
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ISS Live Stream 


Educational Channel HD 


DOWNLOAD OPTIONS 


eal Return of the Kung Fu Dragon 





Media Channel HD 


ISS HD Earth Viewing - ustream 





ISS HD Earth Viewing - urthecast HD 





Queue after current 
Return_of_the_Kung_Fu_Dragon.ogv 





Queue 


Play 


Cancel 





Remotely control your Pi from another computer with VNC Server and Viewer 
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2 VNC Viewer 


VNC® Viewer 


VNC Server: 


Encryption: Let VNC Server choose 


About... Options... 








Display inputs Troubleshooting Expert 


Sealing 
O)No scaling 
(©) Scale to window size 


© Custom scaling 
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| Preserve aspect ratio 


[_] Full screen mode 
Enable toolbar 


Adapt to network speed (recommended) 


(Use these settings for all new connections 


Basic... OK 
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System Interfaces | Performance | Localisation 
Camera *) Enabled Disabled 
SSH *) Enabled Disabled 
VNC Enabled *) Disabled 
SPI Enabled +) Disabled 
I2C Enabled ©) Disabled 
Serial Enabled +) Disabled 
1-Wire Enabled +) Disabled 
Remote GPIO Enabled +) Disabled 

Cancel OK 
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By using the command line, you are able to work faster and smarter. 
Discover how to get started today... 





® OCS * © Bieaextnp - 





<< 


1 Sar: Ca i 


. sm™ ied = 
6 OCB * © Eipacstenp:~0 





pi1@ra 





spberryp1L: 


pi@raspberrypi' ~/Documents 





pi@ 


raspberrypi 


~/Documents 


mg CDR “> SF EE n => «|1837 
® © OB * CO Biecestenn: - V2 3 SF 4) | tas}143 





pi@raspbenypr ~ 


pi@raspberryp1: ls -lah /home/pi/Documents/ 
total 20K 
drwxr-xr-x 5 pl pil 4.0K Dec 15 14:37 

drwxr-xr-xX 31 pl pl 4.0K Dec 15 12:52 

-rw-r--r-- 1 pl pl O Dec 15 14:37 a_file.txt 
drwxr-xr-xX 11 pl pl 4.0K Nov 25 17:49 

drwxr-xr-x 5 pl pl 4.0K Nov 25 17:49 

drwxr-xr-x 2 pl pi 4.0K Nov 25 17:46 
pl@raspberryp1: 





pi@raspberrypi: ~ 








The permission structure 
of a Unix file or directory 


file . RN 
a® ° 
D> \ @ 
« ew og 


q tw xin 


——> —— 


directory owner group other 








System 
Filesystem: 
Password: 


Hostname: 


Boot: © To Desktop © |To CLI 


Auto Login: ‘ Login as user ‘pi’ 
Network at Boot: ) Wait for network 


Splash Screen: © Enabled © Disabled 
Underscan: ©) Enabled © Disabled 
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Options 

Most commands have options that affect how they 
work. It’s common to use these three options with 
the 1s command: 


ls -lah 


Options start with a single hyphen ‘-’ followed the 


letter for each option. The three options used here are: 


-1 = long listing format 

-a = all including hidden files 

-h = human-readable (makes large file sizes 
more readable) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small ‘I’ is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
sameasls -lah: 


ls -1 --all --human-readable 


But it’s more common to see (and use) the single 
letter approach. 


TT ele) 
Sudo stands for ‘substitute user do’, although it’s 
often also called ‘superuser do’. If you have multiple 
users On your system, it can be used to perform 
commands as another user. 

It’s mostly used to get root access to your Linux 
installation. There is an account that controls your 
Pi user, called ‘root’. This is an all-powerful account, 


which can change just about anything on your system. 


Your default account can view files in the root of 
the hard drive, but it can’t create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You’ll see touch: cannot touch ‘test.txt’: 
Permission denied. However, enter: 


sudo touch test.txt 


...and the test.txt file will be created on the root of 
your hard drive. You can see it using1s -1. 
Now try to delete it: 


rm test.txt 
It will say rm: remove write-protected regular 
empty file ‘test.txt’?” Enter Y and it’ll say rm: 


cannot remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 


icicle) e\- say elkelcevaaniale]e) 


COMMAND - 


sudo rm test.txt 

























You can see why sudo is such a powerful tool. 
Without it, you couldn’t install software using apt 
or apt-get. But with it, you can remove or delete vital 
system files. Enter1ls /bin and you’ll see many 
programs (known as ‘binaries’) used by Linux. These 
include the 1s command you just used. Accidentally 
deleting these files could make your system unstable. 

So use sudo with care. In Raspbian you don’t need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to is man. This stands for ‘manual’ and gives you 
instructions on Linux commands and tools. Enter: 


man ls 


...and you’ll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 
Almost all commands are in the ‘command, option, 
argument’ structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or --help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to acomman4d line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don’t head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it’ll be second nature. 
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Terminal 


tx] pi@raspberrypi: ~ 


Lucy@Lucy-MacBook:~$ ssh pi@192.168.0.19 

The authenticity of host '192.168.0.19 (192.168.0.19)' can't be established. 
ECDSA key fingerprint is SHA2S6:k2RP2BuKYuu1UF79nN1WT8Sv+6ZGLF3mg3r yH4z0/oSE. 
Are you sure you want to continue connecting (yes/no)? yes 


Warning: Permanently added '192.168.0.19' (ECDSA) to the List of known hosts. 


pi@192.168.0.19's password: 


The programs included with the Debian GNU/Linux system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 
permitted by applicable law. 

Last login: Tue Dec 6 10:14:12 2016 from 192.168.0.38 
piGraspberrypi: ls 
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Raspberry Pi Configuration - 
| 


system 
Camera: 
SSH 
VNC 
SPI 
I2C 
Serial 
1-Wire 


Remote GPIO 


Enabled 
Enabled 
Enabled 
Enabled 
Enabled 
Enabled 
Enabled 


Enabled 


Cancel 


Interfaces | Performance | Localisation 


Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 


OK 














Category: 
=} Session Basic options for your PUTTY session 
" — Specify the destination you want to connect to 
= enmina . 
Risin Host Name (or IP address) Port 
~ /192.168.0.19 ||22 
Bel ve. 100 || Kn 
Features Connection type: i" : 
Window ()Raw ()Teinet ©)Riogin @SSH (©) Seal 
Appearance 
te : 2 Load, save or delete a stored session 
ehaviour 
Selection | 
C Colours Default Settings Load 
rw, = =} Connection 
B) Ga [rm i> i@raspbenypi: ~ 
ors CY Ei recspbenp Data Save 
aa ete rae Ha Proxy 
Telnet Delete 
Riogin 
+)» SSH 
Serial Close window on exit 
©) Always (©)Never @)Only onclean ext 
About Open Cancel 
op pi@raspberrypr ~ - oO 


©®© tucy@lucy-MacBook: ~ 

Lucy@lucy-MacBook:~$ ssh pi@192.168.6.19 

The authentictty of host '192.168.6.19 (192.168.6.19)' can't be established. 
ECDSA key fingerprint is SHA256:k2RP2BuKYuUlUF79NIWTBSV+6ZGLF3mg3ryH4z0/oSE. 


«Are you sure you want to continue connecting (yes/no)? yes 
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Discover the easy way to control GPIO pins on your Raspberry Pi 
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qanquage 


>PYTHON 


DOWNLOAD: 
button.py ede eonrav 


from gpiozero import LED, Button 
from signal import pause 





led = LED(17) 
button = Button(21) 


button.when_pressed = led.on 
button.when released = led.off 


pause() 


traffic_lights.py 


from gpiozero import LED 
from time import sleep 


— red = LED(25) 


amber = LED(8) 
green = LED(7) 


green.on() 
amber .off() 
red.off() 


FT Ban 


>STEP-07 Sleep(10) 





while True: 


Adding a button green.off() 
Now we’re going to add a button to our circuit and amber .on() 
connect it to GPIO21 with an LED wired up to GPIO17. Sleep(1) 
Buttons are wired up ina Similar fashion to LEDs, amber .off() 
using female-to-male jumper leads. red.on() 
Like LEDs, buttons have legs. One leg is wired to a sleep(102) 
GND pin (via the same ground rail you’ve been using amber .on() 
for LEDs); the other leg is connected to a GPIO pin. Sleep(1) 
Some buttons have four legs, so you can connect green.on() 
them to the breadboard with their legs straddling amber .off() 
the central groove (see the breadboard diagram). red.off() 


>STEP-08 


Button responder : 
Unlike LEDs, you don’t need to use a resistor with a Going further 


button. The button’s legs are the same length, and it 





Magi 





typically doesn’t matter which way around you hook You can achieve a lot more with GPIO Zero than SIVI2nS 

it up to the breadboard. controlling LEDs and buttons. ELECTRONICS 
When the button is pushed, it forms a connection For a more detailed look at how you can detect WITH 

between the ground rail and the pin, completing a motion, control robots, read sensor information CYA A nO) 

circuit. The Raspberry Pi is set up, using GPIO Zero, (such as movement sensors or thermometers), a Pi 

to detect this connection and respond. The MagPi's Phil King has created a fantastic guide: = = y 
Open Python shell and create a new file. Enter the MagPi Essentials: Simple Electronics with GPIO Zero. 

code from button.py, save the file, and run the code. Learn more at magpi.cc/Back-issues. 


When you push the button, the LED will light up. 


——)  qeo£_ qcx— 
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This humble plastic block full of holes can be used to create just about anything 
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Tutorial | RASPBERRY PI 101: CODE IN PYTHON WITH THONNY 
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Use the new Thonny IDE to understand what’s going on in your code 

















> Raspberry Pi 


> Latest version 
of Raspbian 


> Thonny 





rays — —- 
print("Hello World")| 





et 
python 3.4.2 


>>> %Run hello.py 

Hello World! 

>>> name = “Lucy” 

>>> print("Hello " + name) 
Hello Lucy 





| File Edit View Run Tools Help 
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class Animal(): 
def _init (self, ¢, mn): 
self.creature = ¢ 


You can see the values self.name =n 
stored in your variables as 


ret if creature 
you run the program DEN es tee tee 









def get_name(self): 
return self.nane 


animals = [) 





Take (=) ol0feMaaete (MM Maedalany Sabet 
alfolalicelaiecmexele(-B-lateMavlacMimeola(-M-jx-lok-|ammm © | * creeture) 
a time, so you can see what each code 


element is doing 


The Heap window displays the Nine ni Anca Eolas 
memory addresses of objects, functions, ee aia eae oe 
Vale Mo) dat-1a-1(-aa(-1aleKemy(olela o)gereleclaa 


Claws is o Cat s : “ yer | : f ee 
Wabbles is a Mouse C1lilL ap ‘ ( r C ] ACC H 


2>> Webug animals.py 
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n= 10 


le n> 0: 
prantin) 
new] 


print( “Blast 


while n> 6: 
printin) 


print( "Blast 


print(n) 
n-=l 


offt'*) 


off! 


print("Slast 0 ol | 


) 


n= 3 


oem 


def count(n): 
if n> 6: 


print(n) 


count(n-1) 


Ls 
print("Blast off!") 


count (3) 
6 

$ 

4 

3 

> 

5 


def 


counti(n): 


els 


print(n) 
count(n-1) 


print("Blast off ) 


animals.py 


class Animal(): 
def init ( pe Gen) 
.creature C 
.name n 


def get _creature( ie 
.creature 


def get_name( ye 
.name 


animals [ | 


animals.append (Animal ( 
animals.append (Animal ( 
animals.append (Animal ( 


animal animals: 
name = animal.get name() 
creature = animal.get_creature() 
print(name creature) 


countdown_recursion.py 


n 
def count ( ): 
Nn e 
print(n) 
count(n-1) 


Seine’ ) 


count(n) 


countdown.py 


n 
print(n) 
n 


print ( ) 





Turn your Raspberry Pi into a file server to back up and share content 
from anywhere on your local network 








A 32GB micro and widely supported by media streamers 

SD card 

Raspberry Pi 2/3 MM MATSMMURosS TESST uatecnas tel (elt TRTTSCE- 

, Monitor, mouse, and monitor to set up your file server, but you network, and 1S < 
keyboard and can alternatively enable SSH (magpi.cc/1G 1Tr) overything from music f 
mouse (for | ; 


setup) 


Wired Ethernet 
connection 


NOOBS ae Ur ee ok ee ae DS an ae onan a aren 


magpi.cc/ | ons wee 
2bnf5XF } accessible. However, if you need extra storage, it’s easy 





| File Edit Search Options Help 
'# printer drivers 
[print$] 
comment = Printer Drivers 
ath = /var/lib/samba/printers 
rowseable = yes 
read only = yes 
guest ok = no 
# Uncomment to allow remote administration of Windows print drivers. 
‘# You may need to replace ‘lpadmin' with the name of the group your 
# admin users are members of. 
# Please note that you also need to set appropriate Unix permissions 
# to the drivers directory for these users to have write rights in it 
; write list = root, @lpadmin 





























An entry in /etc/samba/ 













[share] This is the location of the 
comment = Pi shared folder folder we're going to share 
path = /share 
browseable = yes 
writeable = yes 
only guest = no 
create mask = 0777 We've enabled guest access, so 


directory mask = 0777 network users won't need a username 
- and password to access the share 
public = yes 


guest ok = yes 
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smb.conf will create the top-level 
oli c=eq Ko) aVMe) MYColel mi at-l a=) 
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RASPBERRY PI 101: BUILD AN INTRANET WEB SERVER 


Build a local HTML server with Apache 
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The Custard Conundrum 










Your site's title, like its 
structure, is defined in the HTML 
foxolo (= Me) Mi dat-w ol-le(- mY ole meleltey-\eRcel|s 






This is the address 
of your new website 





Your new website 
(custard optional) 
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v ‘ F with Debion took. TI ation systery fully doc umented 
in /use/share/doc/apache2?/README.Debian.gz, Reter to this for the full docunertatio 


ment, 


r the web server itself can be fou ¥ accessing the manual if the apache2-d 
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Back up the files on a Raspberry Pi so you can quickly restore your files 





Raspberry Pi 
SD card 


Flashdrive J E ca you he 


PXoCollave i= ots /Le) ce Kom (ole lm ol- ode) oMer-la B-cell leo mial— 
files stored remotely (or on an external drive) 


DY =}F- DIU oN ow ole) olUit-lmelceyele-lan) Files backed up using Deja Dup are 


















used to schedule backups 


restored using the same program 


[| - « 
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Require Password? ~~ Last backup was today. 
Folders to save f= You can restore the entire backup with the Restore... button or use Files to either 
© Allow restoring without a password . revert individual files 01’ restore missing ones. 
® Password-protect your backup Folders to ignore 
tore. 
You will need your password to restore your files. Storage location — 
You might want to write it down. 








Scheduling 






No backup scheduled. 
You should enable automatic backups or use the Back Up Now... button to start one now. 


Back Up Now 


cerpiopanod| = 
a 


.) Show password 
() Remember password 
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BACK UP YOUR RASPBERRY PI 


Restore Finished 


Your files were successfully restored. 





vy No recent backups. 
G9 You may use the Restore_. button to browse for existing backups. 
L Restore. J 


No backup scheduled. 
You should enable automatic backups or use the Back Up Now... button to start one now. 








Above: =\\== 
can be restored 
Tate (Vice lUre\A Vane) g 


SS Win32 Disk Imager 
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Don’t let your Raspberry Pi suffer from a shortage of volts 








= | 
F = 
= | 


Raspberry Pi ModelA 
Raspberry Pi Model B 
Raspberry Pi Model A+ 
Raspberry Pi Model B+ 
Raspberry Pi 2 Model B 
Raspberry Pi 3 Model B 
Pi Zero / Pi Zero W 


700mA 
1.2A 
700mA 
1.8A 
1.8A 
2.5A 


1.2A 


ST 
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The Raspberry Pi ower Usage 
































Universal Power Supply 
Boot Max 0.26A 0.40A 0.75A 0.20A 
Avg 0.22A 0.22A 0.35A 0.15A 
Idle Avg 0.20A 0.22A 0.3a0A 0.10A 
Video playback (H.264) Max 0.30A 0.36A 0.55A 0.23A 
Avg 0.22A 0.28A 0.33A 0.16A 
Stress Max 0.35A 0.82A 1.34A 0.35A 
Avg 0.32A 0.75A 0.85A 0.23A 


Test conditions used a standard Raspbian image (26 Feb 2016), at room 
temperature, connected to an HDMI monitor, USB keyboard, and mouse. 

For the Model 3B it was connected to a WiFi access point. All these power 
measurements do not take into account power consumption from additional 
USB devices; these measurements can easily be exceeded with multiple 
additional USB devices connected or when using a HAT. 


500mA 200mA 
500mA 500mA 
500mA 180MA 
600mA/1.2A (switchable) 330MA 
600mA/1.2A (switchable) 350MA 
1.2A ~400MA 
1.2A 200mA 
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The basic commands you need to get advice from the Linux command line 


® OCB *® CO Egecestenp - % TL 4) [Rea 1317 








mm) CY (= fi , 
} G) f (= ‘> >. @raspbenypi: ~ 








Many commands 
feature a built- 
in help option, 

t le: accessed with -h 
specified, use tmp 1s or --help. Using it 
Cea ee offers a brief outline 
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Get off to a good start with Minecraft: Pi Edition. 
Play the game and write your first program using the API. 


The mouse changes where you look 

Holding the left button destroys blocks 

Right button places blocks 

W, S, A, D move you forward, backward, left, 
and right 

1, 2, 3, 4,5, 6, 7, 8 change what you are holding 
E opens the inventory 

ESC takes you back and to the Menu 

SPACE is jump. Double-tapping it makes you fly 
or stop flying 


Lal Minecraft - Pi edition [-JleJL 
- 9.0; 57.7 


ello Minecr aft Wor Ld 





Get the player’s position 

Change (or set) the player’s position 

Discover the type of block at a specific location 
Change a block 

Change the camera angle 

Post messages to the player 











Go to the Minecraft menu with ESC, but leave 
the game running (you can minimise it). 
Open IDLE by clicking Menu > Programming > 


WATCH FOR 
; ; RED TEXT 
Use File > New File to create a new program and 


Python 3 (IDLE). 





save it as hellominecraftworld.py. 

At the top of your program, type the following 

code to import the minecraft module, which 

will allow you to use the API and talk to the game: 

import mcpi.minecraft as minecraft 

On the next line, create a connection from your 

program to Minecraft and call it me: 

mc = minecraft.Minecraft.create() 

Use your Minecraft connection and the 

function postToChat() to put a message in 

the chat window on a third line: PYTHON 
mc.postToChat("Hello Minecraft World") IS CASE- 
Run your program by clicking Run > Run Module. SENSITIVE 





PNG 0) Kotor aa) 
I lTalexed esa Ml ate \\iowrs| 
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Teleport the player by setting their position: 
mc.player.setPos(@, 50, @) 

Run your program by clicking Run > Run Module. 
Quickly switch back to Minecraft to see your 
player fall to the floor (unless in flying mode). 





If you’ve completed the Minecraft Pi learning resources at 
raspberryp1i.org, check out these pro tips and mini programs 
to learn more about the coding in Minecraft... 


Create massive 
houses in the blink of 
an eye using just a few 
lines of code 
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CHANGE THE CAMERA 


Bored of always following Steve around? You can alter 
the position of the ‘camera’ in Minecraft to change how 
you see the world. 

You can change the camera to follow Steve while 
Kote) <ahateaebhacrora hye (@)i\0lr-len obbe0 hue) mem (ele).qeleiiseu-lmaala 
world from any coordinate in Minecraft. 

The camera. setFollow() function will change your 
view so you are looking down at Steve. In a new Script: 


from mcpi import Minecraft 
mc = minecraft.Minecraft.create() 


mc.camera.setFollow() 


To change the camera to look down on any position, 
you use the camera.setFixed() function before using 
camera. setPos() to change the position of the camera. 
If you wanted to set the camera 25 blocks above the 
Spawn position, you would use: 


i em of-111(=) ar: {0 ol ow <-10 1 @) 
em of-111(=) ar: RY =0 2 0-1 @ 2 do «Dp 


To set the camera back to normal, you would 
DESomO BLOM of-111(=) wr: PET=29) (0) oT © RON eLeLa een 
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mc.camera.setNormal() 


Using the camera functions, you could hide a 
diamond block (57) in the world, then tease the 
player by changing the camera to show them where 
it is before challenging them to find it. Try this ina 
new program: 


from mcpi import minecraft 
from time import sleep 
mc = minecraft.Minecraft.create() 


mc.postToChat("Here is the Cee 
block I have hidden." ) 
mc.setBlock(100,25,100,57) 
mc.camera. setFixed() 
mc.camera.setPos(100, 30,100) 
sleep(10) 


mc.postToChat("Go find it!") 
mc.camera.setNormal() 


You could change the program above to drop 
the diamond block in a random position and use 
getHeight() so the diamond block is always on the 
top of the world. 
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mcpi minecraft 
mc = minecraft.Minecraft.create() 


#make the world read-only 
mc.setting( » True) 


#make the world writable 


mc.setting( » False) 
mcpi minecraft 
time Sleep 


mc = minecraft.Minecraft.create() 
mc.setting ( » True) 
mc .postToChat ( 


sleep(10) 
mc .postToChat ( ) 


mc.setting ( , False) 
Sleep(60) 
mc. postToChat ( 


) 
mc.setting( » True) 





Have you exhausted the Minecraft: Pi basics available from raspberryp1. 
org/resources: Have you completed our Minecraft Pi coding tips? Here 
are another five tips and mini-programs to experiment with... 


pi@rpi2 cd ~/.minecraft/games/com.mojang/minecraftWorlds 
p1@rpi2 ls 


p1i@rpi2 


tar czf world--backup.tar.gz world-- 
p1@rpi2 


world--backup. tar.gz 


p1i@rpi2 
tar xzf world--backup.tar.gz 
p1i@rpi2 
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mcpi minecraft 
mcpi block 


mc minecraft.Minecraft.create() 


pos mc.player.getTilePos() 


mc.setBlock(pos.x, pos.y », pos.z, block.STONE) 


# create torches 

# on top 

mc.setBlock(pos.x, pos.y >, pos.z, block.TORCH) 

# to the east 

mc.setBlock(pos.x y pos.y » pos.z, block.TORCH) 
# to the west 

mc.setBlock(pos.x y pos.y -» pos.z, block.TORCH) 
# to the north 

mc.setBlock(pos.x, pos.y » pos.z » block.TORCH) 
# to the south 

mc.setBlock(pos.x, pos.y }» pos.z » block.TORCH) 


mcpi minecraft 
minecraft.Minecraft.create() 
mc.saveCheckpoint( ) 


mc.restoreCheckpoint() 


mcpi minecraft 
time sleep 


minecraft.Minecraft.create() 





#every 3@ secs save a checkpoint 
count : 
mc.saveCheckpoint() 
mc.postToChat("Checkpoint saved") 
count 
sleep(1) 


#if a block is hit, restore checkpoint 
mc.events.pollBlockHits(): 
mc.restoreCheckpoint() 
mc.postToChat ("Restoring 
checkpoint" ) 
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CALCULATING THE DISTANCE 
BETWEEN TWO BLOCKS 


When coding Minecraft, it’s really useful to know the 
distance between two blocks — and by using some 
(fairly) simple maths, we can work it out. This can 
be used in loads of fun ways, such as a hide and seek 
game where a diamond block is hidden and Steve is 
told whether he is getting colder or warmer. 

The maths works like this: 


MINECRAFT: PI 


from mcpi import minecraft 
from math import sqrt 

from time import sleep 

mc = minecraft.Minecraft.create() 
startPos = mc.player.getTilePos() 


while True: 


posNow = mc.player.getTilePos() 


Tutorial 


01 Calculate the difference between the x, y 


& z coordinates of the two positions 


(02 Multiply the difference by itself (its square) 


03 Add all the squares together 


04 The distance equals the square root 


of the total above 


xDiff = startPos.x - posNow.x 
yDiff = startPos.y - posNow.y 

zDiff = startPos.z - posNow.z 
xSquare = xDiff * xDiff 

ySquare = yDiff * yDiff 

zSquare = zDiff * zDiff 

total = xSquare + ySquare + zSquare 





This program uses this calculation to display how 
far the player is from where they started. So the 
further they move away, the greater the distance. See 
how it works by copying the following code example 
into IDLE or your favourite text editor (don’t forget to 
save it with the .py file extension): 
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distance = sqrt(total) 
mc.postToChat (distance) 


sleep(1) 


Try changing the program to show the distance between 
the player and a random diamond block you have created. 
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MM  carning to code is one of the most profoundly 
ie life-changing things you can do. This has 
always been true, but learning to code is 
increasingly important in the modern world. 

The reason the Raspberry Pi was created was to 
» challenge a drop in computer science applications 

at Cambridge University. Modern computers, and 

especially games consoles, were fun and powerful, 
but not easily programmable. 
The maker community fell in love with the 
Raspberry Pi, thanks to its cheap and hackable 
nature. Building and tinkering are the primary 
reasons we love Raspberry Pi. Great projects use a 
combination of hardware and software together. 

So, whether you’re a hacker learning to make 
better projects, or a would-be coder looking for 
a better career, this feature is set to help you on 
YOUL Way. 

The good news is that you don’t need to be a genius 
to know coding, just as you don’t have to be a genius 
to read and write. It’s actually pretty simple once you 
learn a few simple concepts like variables, branching, 
and loops. 

Perhaps you’re brand-new to coding. Maybe you 
did a little BASIC in school, or used old languages like 
Pascal and Fortran. Or maybe you’re already knee- 
deep in projects and just want to learn the language 
that controls them. 

Wherever you’re coming from, we’re here to 
walk you through the basic concepts of computer 
programming. We’ll demystify the whole process of 
code, so you can get a better understanding of what’s 
going on inside your Raspberry P1. 
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Code Matters 


mi hialial @=\V-laelere\alamsal cmecolelaitavaciavelullomt-r-lgamvon e)colelr-laanre| 
computer,” said Apple's co-founder Steve Jobs, “because it 
teaches you how to think." 

Code is a critical layer in our lives that sits between us 
Yale Maro laleig=resilaleiNmel(eli=laucelacemdal-imolelacelulalecMetmydligl 
ploimr= Biaal=ldm-laarelelalmermelare(=)e-ir-laveliale Maren merele(- Re) cr 
you'll be able to perform computer tasks faster and get a 
loX=yan=lm@Ulale(-le-ir-lalel|ave me) mual-mu cel lom-lcolularomvelem arenes ciale| NVA 
ale laatelalcw- late Maate\etallat= ome le-my cole dale mkoye(-1sa(=18 

M=F-\eallave mkomut-necole(-¥-laleMat-lce\\(cleom cM lalergcre lle) iy 
(Vaal eleyw/(= 1a late m@e)galeluixsigce-lcoM core liNva-loreluimalelaal=lali nem mes 
eloreluimal=1l e)/ale el-re)e)(-mo)’MUlciiale mn=re1alare)tole WAY (Aai=ital-) al momal= 
lave) gat=tuaats(e(oMe)e)aliarellaalevece)ol-u-t-\ilalem=\-s1(elal Mian larelts Wels 
the Computer Aid Connect taking the internet to rural Africa, 
code on the Raspberry Pi is making a real difference. 

Coding also makes you more creative. It enables you to 
automate a whole bunch of boring and repetitive tasks in 
WelUlm@lic-Mmigst lave mielemel omcoKero)aler-ialic-lk-Molamialmielamciieiip 

It also teaches you how to solve problems in your life. 
=r \dallale MKomate\y axon olUimuallale low iake)ce(=1em-larem ace) mcel elgaralid 
down a big, seemingly impossible task into several small 
lolU\ mr-\o1 al(=wV- le] (om kalo] <u ome) geyele lace |\Vmulcotresal=lale laren 

And if you're looking for a career boost, there's plenty of 
worse things to learn. “Our policy is literally to hire as many 
engineers as we can find,” says Mark Zuckerberg, CEO 
of Facebook. “The whole limit in the system is that there 
[eim=lc>)amm=ralelelelau elzre) Kai dalek=\¢-mirslla(semcomat=\.omia loss 
skills today.” 
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Python is an ‘interpreted language’ 
You write the code and then run the 
program. Under the hood, it’s being 
translated and runs on the fly. Some 
languages, such as C and Java, are 
compiled. You write the program, then 
compile it to get a build file (written in 
machine code), then you run the build. 
It's a faff you can do without for now. 


Discover the building blocks of software 
@ and learn what goes on inside a program 


efore you go any further, let’s look at what a 
program actually is. The dictionary definition 
is a “set of instructions that makes a 
computer do a particular thing.” 

A computer program is a lot like a recipe. It has 
a list of ingredients, called ‘variables’, and a list of 
instructions, known as ‘statements’ or ‘functions’. 
You follow the instructions from the recipe one line at 
a time and end up with a tasty cake - and that’s no lie. 

The real miracle of computers, however, is that 
they can do the same thing repeatedly. So you can 
get a machine to bake a thousand cakes without ever 
getting tired. A program may contain loops that make 
it do the same thing over and over again. 

Programs also make decisions, and different paths 
through a program can be taken. Your recipe could 
make a scrummy chocolate cake or a delightful 
batch of doughnuts, depending on the variables (the 
ingredients) it has. 
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One thing that may surprise you when you begin 
programming is just how little you need to know to 
eet started. With just a few variables, a smattering 
of flow, and some functions, you can get a computer 
doing all the hard work for you. 


Inside your Pi 

At the heart of your Raspberry Pi are billions of voltage 
switches known as binary digits (or ‘bits’ for short). 
There are 8,589,934,592 of them in its 1GB of RAM, to 
be exact. All these switches can be set to high or low, 
which is typically represented as o (for low or off) and 
1 (for high or on). Everything you see on the screen, 
hear from the speakers, and type on the keyboard is 
billions of switches being turned on and off. 

Obviously, it’s not that easy for humans to talk 
directly to computers. It’s possible to use machine 
language and send binary instructions directly toa 
computer, but this isn’t where any sane person starts 
(or ends if they want to remain sane). 

Instead, we use a coding language to program. This 
is written using easy-to-understand functions like 
print(). These are then interpreted into machine 
language, which the computer understands. 

We’re going to use Python to learn to code. Python 
is a truly great programming language. It has a rich 
syntax that’s free from clutter, you don’t have to 
worry about things like curly braces and static typing 
that crop up in more complicated languages like Java. 

With Python, you can just create code, run it, and get 
things done. Python is one of the languages found most 
commonly on The Raspberry Pi, so learning it here will 
help you understand lots of the code used in projects. 
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IDE and IDLE 


You don’t have to write Python programs using a text 
editor like Leafpad and run them in the terminal. 
Instead, you can use a neat all-in-one solution, known 
as an ‘IDE’ (integrated development environment). 

IDEs combine a text editor with program-running 
functionality. Often, they’ ll include fancy features like 
debugging and text completion. 

Click Menu > Programming > Python 3 (IDLE), and Above Python IDLE makes it easy to create programs and 











you’ ll get a new window called ‘Python 3.4.2 Shell:’. run them without having to use the command line 

This Shell works just like Python on the command line. Don’t forget to include the space after ‘Hello’. Choose 

Enter print("Hello World") to see the message. File > Save As and save it as hello.py. Now press F5 on 
You can also create programs in a built-in file your keyboard to run the program. (Or choose Run > 

editor. Choose File > New File. Enter this program Run Module). [t’!] display ‘Hello World’ in the Shell. 

in the window marked ‘Untitled’: The advantage of using Python IDLE is that you can 

inspect the program in the Shell. Enter word1, and 

word1 = "Hello " you’ ll see ‘Hello’. Enter word2 and you’1l see ‘World’. 

word2 = "World" This ability to inspect and use the variables in your 

print(word1 + word2) program makes it a lot easier to experiment with 


programming and detect bugs (problems in your code). 


Python comes 
pre-installed in the 
Raspbian operating 
system and you 
can use it at the 
command line 
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Variables are all-purpose containers that you use to store data and objects 


Python has five 
standard data types: 
@ Number 

T Sislale 

@ List 

@ Tuple 

@ Dictionary 


You'll come 
across foo’ and 
‘bar’ a lot when 
K=yel gall ave mkomerele(=3 
These are dummy 
jelks\ex=) alo) Ke (=1goe-l ale! 
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They could be zig 


relate Waele Kolme)laak-lare. 
bam. Nobody's 
quite sure, but it 
might be related 
to the expression 
hivley-lamicelaamtal= 
Witeitalelaaloom cele 





f you’ve created a science project or 

experiment, you may have come across 

variables. In science, a variable is any factor 
that you can control, change or measure. 

In computer programming, variables are used to store 
things in your program. They could be names, numbers, 
labels, and tags: all the stuff your program needs. 

In Python, you write the name of a variable then a 
single equals sign and the word, number or object you 
want to put in it. 

Enter this code directly into the Shell: 


1 
Z 


Foo 
bar 


Remember: the variable name is on the left, and the 
thing it contains is on the right. Imagine you’ve got 
two plastic cups, and you’ve scrawled ‘foo’ on the first 
and ‘bar’ on the second. You put a number 1 in foo and 
a number 2 in bar. 

If you ever want to get the number again, you just 
look in the cup. You do this in Python by just using the 
variable name: 


foo 
bar 


You can also print out variables by passing them 
into a print function: 


print(foo) 
print(bar) 
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Variables can also be used to contain ‘strings’. 
These are groups of letters (and other characters) 
that form words, phrases or other text. 

Creating a string variable in Python is pretty 
much the same as creating an integer, except 
you surround the text with single (" ') or double 
(" ") quotes. 

Using double quotes makes it easier to include 
apostrophes, such as print("Don’t worry. Be 
Happy” ). This line would break after ‘Don’ if you used 
single quotes — print('Don’t worry, be happy' ) 
— so use double quotes for now. 


Why variables count 

Variables make it much easier to change parts of your 
code. Say you’ve got an excellent coding job at Nursery 
Rhymes Inc and you’ve written a classic: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’1l1 all have tea") 


The head of marketing comes in and says “our data 
shows that Polly isn’t trending with the millennial 
demographic.” You say “Huh!” and he barks “Change 
Polly to Dolly.” 

You now have to go through and change the variable 
in all three lines. What a downer! But what if you’d 
written thousands of lines of code and they all needed 
to change? You’d be there all week. 

With variables, you define the variable once and 
then use it in your code. Then it’s ready for changing 
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at any time: 
name = "Polly" 


print(name + " put the kettle on) 
print(name + " put the kettle on) 
print(name + " put the kettle on) 
print("We’1l1 all have tea") 


This code prints out the same classic nursery rhyme. 


But if you want to change the name of our character, 
you only have to change it in one place: 


name = "Dolly" 


...and the poem will update on every line. 


What's your type? 
When you create a variable in Python, it’s 
automatically assigned a type based on what it is. You 
can check this using the type() function. In the shell 
interface, enter: 

foo = "Ten" 
bar = 10 


Now use the type() function to check the type of 
each variable: 


type(foo) 
type(bar ) 


It willsay<class 'str'> for foo, and <class 
‘int'> for bar. This concept is important, because 
different types work together in a variety of ways, and 
they don’t always play nicely together. 

For example, if you add together two strings they 
are combined: 


name = "Harry" 
job = "Wizard" 
print("Yer a " 


+ job + + name) 

This prints the message “Yer a Wizard Harry”. The 
strings are concatenated (that’s a fancy programming 
term for ‘joined up’). Numbers, though, work 
completely differently. Let’s try a bit of maths: 


6 
9 


number1 
number2 


print(number1 + number2) 
Instead of concatenating 6 and 9 together to give 


69, Python performs a bit of maths, and you get the 
answer ‘15’. 


raspberrypi.org/magpi 


Type casting 
So what happens when you want to add a string and 
an integer together? 


name = "Ben" 
number = 10 
print(name + number) 


You’ ll get an error message: ‘TypeError: Can’t 
convert 'int' object to str implicitly’. This error is 
because Python can’t add together a string and an 
integer, because they work differently. Ah, but not 
so fast! You can multiply strings and integers: 


print(name * number) 


It’ll print ‘Ben’ ten times: you’l get 
‘BenBenBenBenBenBenBenBenBenBen’. 

If you want to print out ‘Ben10’, you’ll need to 
convert the integer to a string. You do this using 
a str() function and putting the integer inside 
the brackets. Here we do that, and store the result 
in anew variable called number_as_ string: 


number_as_string = str(number) 
print(name + number_as_string) 


This code will print out the name ‘Ben10’. This 
concept is known as ‘type casting’: converting a 
variable from one type to another. 

You can also cast strings into integers using the 
int() function. This is particularly useful when you 
use input() to get a number from the user; the input is 
stored as a string. Let’s create a program that asks for 
a number and exponent and raises the number to the 
power of the exponent (using the ‘**’ symbol): 


number = input("Enter a number: ") 
exponent = input("Enter an exponent: ") 
result = int(number) ** int(exponent) 


Our first two variables, number and exponent, g 


are Strings, while our third, result, is an integer. 
We could just print out the result: 


print(result) 


But if we wanted to include a message, we need to 
type cast result to a String: 


print(number + 


raised to the power 
+ exponent + " 


is " + str(result)) 


feature 


What 
to calla 
variable? 
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. 
. 
‘ 
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\* 
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Variables, types, and type casting can be a bit tricky at 
first. Python is a lot easier to use because it dynamically 
changes the type of a variable to match the thing you put 
in it. However, it does mean you have to be a bit careful. 
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omputers are great because they don’t mind 
doing the same stuff over and over again. 
Their hard-working nature makes computers 
ideal for doing grunt work. 

When looking at variables earlier, we printed out 
this nursery rhyme: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’1l1 all have tea") 


We didn’t like the repetition of Polly, so we replaced it 
with a variable. But this code is foolish in another way: 
you have to write out the same print line three times. 


We’re going to use a loop to get rid of the repetition. 


The first loop we’re going to look at is a ‘while loop’. 

In Python 3 IDLE, create a new file and save it as 

polly.py; enter the code from the top of the next page. 
We start with two variables: 


name = "Polly" 
counter = @ 


There's a massive nerd debate about whether to use spaces or tabs when 
indenting code. There are valid arguments on both sides, which you can learn in 
this clip from HBO's comedy Silicon Valley (magpi.cc/2gZdeoM). Use spaces for 
now. When you're a hardcore coder, you can make the argument for tabs. 
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Then we use the while statement followed by a 
condition: counter < 3. 

On the next line down, you press the space bar four 
times to indent the code. Don’t press the TAB key 
(see ‘Tabs or spaces®’ boxout). 


while counter < 3: 
print(name + " put the kettle on") 
counter = counter + 1 


The < symbol stands for ‘less than’. 
It checks if the item on the left is less than the 
item on the right. In this case, it sees if the variable 
counter (which starts at 0) is less than 3. This 
condition is known as ‘True’; if it wasn’t, it’d 
be known as ‘False’. 

Finally, enter the last line of code: 


print("We’?11 all have tea") 


Save and run the program (press F5). It will print 
‘Polly put the kettle on’ three times and then ‘We’1] all 
have tea’. 


While, condition and indent 
There are three things here: the while statement, the 
condition, and the indented text, organised like this: 


while condition: 
indent 


Imagine a three-way chat between all three items 
in our polly.py program: 
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While: “Hey Condition! What’s your status?” 
Condition: “True! The counter is o. It’s less than 3.” 
Indent: “OK, guys. I’ll print out ‘Polly put the kettle 
on’ and increase the counter by 1. What’s next” 


While: “Hey Condition. What’s your status°” 
Condition: “True! The counter is now 1.” 
Indent: “OK. I’m printing out another ‘Polly put 
the kettle on’ and increasing the counter by 1.” 


This goes on till the counter hits 3. 


While: “Hey Condition. What’s your status°” 
Condition: “False! The counter is now 3, which isn’t 
less than 3.” 

While: “OK guys. We’re done!” 


The program doesn’t run the indented code, but moves 
to the single print at the end: ‘We’1I all have tea’. 


For and lists 
The next type of loop is known as ‘for’. This is 
designed to work with lists. 

Lists are a type of variable that contain multiple 
items (strings, numbers, or even other variables). 
Create a list by putting items inside square brackets: 


banana_splits = ["Bingo", "Fleegle", 
"Drooper", "Snorky" | 


Now enter banana_ splits in the Shell to view the 
list. It will display the four names inside the square 
brackets. You can access each item individually using 
the variable name and square brackets. Enter: 


banana_splits[@] 


...and you’ ll get ‘Bingo’. Lists in Python are zero- 
indexed; that means the first item in the list is [o]. 
Here are each of the items. Type them into the Shell 
to get the names returned: 





oF 
 -_ o> 
46 

a 

“< 

Se 
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name = "Polly" 
counter = 9 


while counter < 3: 
print(name + " put the kettle on") 


counter = counter + 1 


print("We’11 all have tea") 





banana_splits[0] # "Bingo" 
banana_splits[1] # "Fleegle" 
banana_splits[2] # "Drooper" 
banana_splits[3] # "Snorky" 


Zero-indexed lists can be confusing at first. Just 
remember that you’re counting from o. A for loop 
makes it easy to iterate over items ina list. Create 
this program and save it as splits. py: 


banana_splits = ["Bingo", "Fleegle", 
“Drooper", "Snorky" | 


for banana_split in banana_splits: 
print(banana_split) 


It doesn’t matter what you use as the variable in 
a for loop, as long as you remember to use it in your 
indented code. You could put: 


for dude in banana_splits: 
print (dude) 


It?s common to name the list as something plural 
(such as ‘names’, ‘pages’, and ‘items’) and use the 


singular version without the ‘s’ for the ‘in’ variable: 


‘for name in names’, ‘for page in pages’, and so on. 
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our programs have been slowly getting more 
powerful. We’ve learned to run instructions 
in procedural order, replaced parts of our 
program with variables, and looped over the code. 

But another important part of programming is 
called ‘conditional branching’. Branching is where a 
program decides whether to do something or not. 

Of course, a program doesn’t just decide whether or 
not to do things on a whim: we use the sturdy world of 
loete ere. 

The start of all this is the powerful ‘if’? statement. 

It looks similar to a loop, but runs just once. The if 
statement asks if a condition is True. If it is, then it 
runs the indented code: 


if True: 
print("Hello World") 


Run this program, and it’ll display ‘Hello World’. 
Now change the if statement to False: 


if False: 
print("Hello World") 


...and nothing will happen. 

Of course, you can’t just write True and False. 
Instead, you create a condition which evaluates to 
True or False; a common one is the equals sign (==). 
This checks whether both items on either side are 
the same. Create a new file and enter the code from 
password1.py. This code is a simple program that 
asks you to enter a password; if you enter the correct 
password, ‘qwerty’, it displays ‘Welcome’. 
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Be careful not to confuse the equals logic operator 
== with the single equals sign =. While the double 
equals sign checks that both sides are the same, 
the single equals sign makes both sides the same. 
Getting == and = mixed up is acommon mistake for 
rookie coders. 


What else 


After if, the next conditional branch control you need 
to learn is ‘else’. This command is a companion to if 
and runs as an alternative version. When the if branch 
is True, it runs; when the if branch is False, the else 
branch runs. 


if True: 

print("The first branch ran") 
else: 

print("The second branch ran") 


Run this program and you’ll see ‘The first branch 
ran’. But change True to False: 


if False: 

print("The first branch ran") 
else: 

print("The second branch ran") 


...and you’ ll see ‘The second branch ran’. Let’s use 
this to expand our password program. Enter the code 
from password2.py. 

Run the program again. If you get the password 
correct now, you’ll get a welcome message. Otherwise, 
you’ ll get an ‘incorrect password’ message. 
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Elif 

The third branching statement you need to know 

is ‘elif’. This statement stands for ‘else if’, and sits 
@ ) 

between the if and else statements: Let’s look at an if attempt 

elif statement. Enter this code: 


password = “qwerty” 
attempt = input("Enter password: ") 


== password: 
print( "Welcome" ) 





if False: 

print("The first block of code ran") 
elif True: 

print("The second block of code ran") 





password = “qwerty” 
attempt = input("Enter password: ") 





else: 
print("The third block of code ran") if attempt == password: 
print( "Welcome" ) 
else: 


Run this program and you’ll find it skips the first if 
statement, but runs the elif statement. You’ get ‘The 
second block of code ran’. 

The else statement doesn’t have a True or False 


print("Incorrect password!") 























condition; it runs so long as neither the if or elif Writing FizzBuzz 
statements are True. (Note that the else statement here, The brief for our FizzBuzz is to print the numbers from 1 to Comments 
as always, is optional; you can just have if and elif.) 100. If anumber is divisible by three (such as 3, 6, and 9), 

But what happens if you change both the if and elif then you print ‘Fizz’ instead of the number; if the number Amark of a good 
conditions to True? Give it a try and see whether just is divisible by five, you print ‘Buzz’ instead. programmer is to 
if runs, or elif, or both. Experiment with removing the But if a number is divisible by both 3 and 5, such as ER COMIC in 
else statement and play around. It’ll help you get the the number 15, then you print ‘FizzBuzz’. your programs. 
hang of the if, elif, and else statements. We’re also introducing a new element in FizzBuzz: Commentenic 

; the ‘and’ statement. This checks if two conditions used to explain 
FizzBuzz are both True: that the number can be divided by bits of your 
We’re going to show you a common program used both 3 and 5. It only returns True if both conditions program to 
in computer programming interviews. It’s a classic eee) Iie humans. They 
called ‘FizzBuzz’, and it shows that you understand if, There are three main logical operators: and, or, are completely 
else, and elif statements. and not. The first two are relatively straightforward, ignored by 

First, you need to know about the modulo operator but the ‘not’ operator can be more confusing at first. the computer. 
(%). This is used to get the remainder from a division Don’t worry about it too much; you’!] get the hang of In Python, you 
and is similar to a divide operator. Take this function: it with practice. BEST oe araient 

Enter the fizzbuzz.py code from page 83 to practise ineauthra Hach 

10 / 4 == 2.5 using if, else, and elif elements and logical operators. 


symbol (#). It can 


be ona line on 
If we use a modulo instead, we get this: 


10 % 4 == | any 
soon as Python 


Modulo turns out to be handy in lots of ways. You hits the # it'll 
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This program works out if a number is odd or even: 
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print("The number is even") 
else: 
print("The number is odd") 
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OK - let’s move on to FizzBuzz. 
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Create the building blocks of code and make more robust programs 


ou’ve come a long way since your first 
‘Hello World’. Your programs now check 
for conditions and loop over themselves. 

You’re now writing programs that are known as 
‘Turing complete’, named after Alan Turing, the father 
of computer science and artificial intelligence, who 
hacked the German Enigma code in WWII. 

Now we’re going to take things a little further. 
We’re going to introduce you to a form of modularity 
called functions. 

Functions are blocks of code that you write once 
and can repeat anywhere. It’s a little like being able to 
write a block of text once, and then paste it whenever 
you need it. 


Spotting a function 

Python is packed with built-in functions, 
and you’ve already been using them in your 
programs. Commands like print(), len(), and 

type() are all functions. They’re easy to spot: a 

small command Starting with a lower-case letter 
and followed by a pair of parentheses ‘()’. 
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Using functions 
Let’s take a look at a function called abs(). It stands 
for ‘absolute’, and returns the absolute value of any 
number you pass into it (the bit you pass in is called 
the ‘argument?’). 

An absolute number is the positive of any number, so 
if you write abs(-2) you get 2 back. Try this in the Shell: 


abs(2) # returns 2 
abs(-2) # returns 2 


You can store the returned result as a variable: 


positive number = abs(-10) 

We find it easier to read a function backwards, from 
right to left. The value is passed into the parentheses, 
then the function cranks it and returns a new value. 
This is passed left and stored into the variable. 


Defining a function 

The great thing about Python is that you don’t just 
use the built-in functions: you get to make your own. 
These are called ‘user-defined functions’. 

You create a function using the def keyword, 
followed by the function name and parentheses. 
Inside the parentheses, you list the parameters. 
These are the same as the arguments, only inside the 
definition they are called ‘parameters’. 


def function(parameter): 
return parameter 


raspberrypi.org/magpi 





Our function here doesn’t do anything; it simply 
accepts a parameter and returns it. 

At the end of the function definition is a colon (:). 
The function code is indented by four spaces, just like 
a loop or if/else branch. 

The code inside the indentation runs when you call 
the function. Functions typically include a return 
statement which passes back an expression. 


Working functions 
We’re going to create a function that prints the lyrics 
to Happy Birthday. 

Type out the happy_birthday. py code from the 
histing, then rum ithe SWellemter, 


happy_birthday("Lucy" ) 


This function call uses the string ‘Lucy’ as the 
argument. This string is passed into the function as 
the parameter and is then available for use in the 
indented code inside the function. 


Return statements 
Many functions don’t just run a block of code; they 
also return something to the function call. 
We saw this in abs(), which returned the absolute 
value of a number. This can be stored in a variable. 
In fact, we’re going to recreate the abs() function, 
so you can see how it’s working behind the scenes. 
In maths, you invert a positive/negative value by 
multiplying a negative number by ~1, like this: 


10 * -1 = -10 
-10 * -1 = 10 


We need to create a function that takes a number 
as a parameter and checks if it’s negative. If so, it 
multiplies it by -1; if it’s positive, it simply returns the 
number. We’re going to call our function absolute(). 

Enter the code in absolute.py. When the function 
hits either of the return statements, it returns the 
value of the number (either on its own or multiplied 
by -1). It then exits the function. 

Run the absolute. py code and enter the following 
in the Shell: 


absolute(10) 
absolute(-10) 


Our last program listing is a classic known as 
‘FizzBuzz’; as mentioned on page 81, it will help you 
to understand if, else, and elif. 

You also need to know the modulo operator (%) for 
FizzBuzz. This operator returns the remainder from a 
division. If you don’t know how modulo works, watch 
this video (magpi.cc/2h5XNRO). 

Now work through the code in fizzbuzz.py. 
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def happy_birthday(name): 


def absolute(number): 





happy _birthday.py 





count = @ 
while count < 4: 
if count != 2: 
print("Happy birthday to you") 
else: 


+ name) 


print("Happy birthday dear 
count += 1 








if number < @: 

return number * -1 
else: 

return number 











end = 100 


count = @ 
fizzbuzz.py 


while count <= end: 


if count % 5 == 0 and count % 3 == @: 
print("FizzBuzz" ) 
elif count % 3 == @: 


print("Fizz") 
elif count % 5 == 

print("Buzz" ) 
else: 

print(count) 


count += 1 


Here are some resources you will find useful. 


GPIO Zero Essentials — magpi.cc/2bA3ZP7 

Bi alism 1-101 ts] eome [el (e (=m olele) @->.4e)k-llalomale\waial-me]o1 OWA-1com savadare)amaaceye(ulc= 
provides access to a bunch of features. These are used to hook up 
electronics to your Raspberry Pi via the GPIO pins. 


FutureLearn - magpi.cc/2hs5Sthf 
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Learning Python - magpi.cc/2hzopWC 
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wget http://goo.gl/@ZDOdX -O intro.py 
--no-check-certificate. Open 

the intro.py file in IDLE; all the \ | 


We 
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Importing 


Stand on the shoulders of giants by importing 
other programmers’ code 


Pygame 


If you want to 
KetegaWaale)coe-loleleis 
eave l= laal=mmeval=iet @eleis 
Make Games With 
Python, our free 
Essentials Guide to 


the Pygame module. 


magpi.cc/2h2movh 











his being the modern world, you’re not 
supposed to do all the work on your 

own. Instead, you will often stand on the 
shoulders of other programmers who have done the 
eroundwork for you. 

Your programs can import code created by other 
people using the import statement. This enables 
you to import modules and use their functions — only 
they’re now known as ‘methods’. 

You import the module at the command line, and 
then access the functions using dot notation. This is 
where you list the module, followed by a dot (.), then 
the method. 

A common module to use is math. This allows you 
to access lots of maths methods. Open a Python Shell 
and enter: 


import math 


You now have access to all the methods in math. 
You won’t notice any difference, but if you type: 


type(math) 
...it will say ‘<class 'module'>’. Let’s try out dot 
notation now. Type math followed by a dot and the 
name of the method (function) you want to use: 

math.sqrt(16) 

This gives the square root of 16, which is 4. 


Some methods have more than one argument. The 
math. pow() method raises a number to an exponent: 
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math. pow(64, 3) | 


This returns 262144.0. 

You can also access constant values from a module, 
which are fixed variables contained in the module. 
These are like functions/methods, but without 
the parentheses. 


math. pi 


This returns pi to 15 decimal spaces: 
3.141592653589793. 


math.e 


This returns Euler’s number to 15 decimal spaces: 
2.718281828459045. 

It’s also possible to import methods and constants 
from modules using from. This enables you to use 
them inside your programs without dot notation 
(like regular functions). For example: 


from math import pi 
from math import e 
from math import pow 


Now, whenever you type pi or e, you’ 1l get pi and 
Euler’s number. You can also use pow() just like a 
regular function. You can change the name of the 
function as you import it with as: 


from math import pi as p 


Now when you enter p you’ ll get pi to 15 decimal 
spaces. Don’t go crazy renaming functions with as, 
but it’s common to see some methods and constants 
imported as single letters. 

By creating your own functions, and importing 
those created by other people in modules, you can 
vastly improve the capabilities of your programs. 

We’re going to take everything we’ve learnt and use 
it to create a game of Pong; this is one of the world’s 
first videogames. 

Write out the code carefully in pong.py. Here you’ll 
find variables, functions, loops, and conditional 
branching: all the stuff we’ve talked about. Hopefully, 
you’ll now be able to decipher most of this code. 

If you’re interested in taking Pong further, this 
program is similar to a version of a Pygame program 
by Trever Appleton (magpi.cc/2hgkOUX). His version 
has a scorecard and more advanced code. We’ve kept 
ours simple so it’s easier to start with. 

Hopefully this isn’t the end of your Python, or 
programming, journey. There are lots of places you 
can learn programming from. And you can find 
more programming resources for you in every issue 
of The MagPi (magpi.cc). 





raspberrypi.org/magpl 


01. 
O25 
Q3. 
04. 
Q5. 
06. 
07. 
08. 
9. 
10. 
11. 
12. 
13. 


14. 
ihe 
16. 
a ly 
13 
19 5 
20. 
214 
22; 
2% 
24. 
295 
26. 
27% 
28 
29: 


a0. 


S14 
32. 
33. 
34. 
cir 
30. 
37. 


38. 
cher 


40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
aU. 
D1, 
52% 
53: 
54. 
=o 
ser 
aoe 
55. 
a7, 
68. 
61. 
62. 


O35 
64. 








import pygame, sys 
from pygame.locals import * 


# Set up game variables 

window_width = 400 

window_height = 300 

line thickness = 10 

paddle_size = 50 # try making this smaller for a harder game 
paddle offset = 20 


# Set up colour variables 


black = (@ ,@ ,@ ) # variables inside brackets are ‘tuples’ 
white = (255,255,255) # tuples are like lists but the values don't 
change 


# Ball variables (x, y Cartesian coordinates) 

# Start position middle of horizontal and vertical arena 
bal1X = window_width/2 - line_thickness/2 

ballY = window_height/2 - line_thickness/2 


# Variables to track ball direction 
ballDirX = -1 ## -1 = left 1 = right 
ballDirY = -1 ## -1 = up 1 = down 


# Starting position 
playerOnePosition = 
playerTwoPosition = 


in middle of game arena 
(window_height - paddle size) /2 
(window_height - paddle size) /2 


# Create rectangles for ball and paddles 

paddlei = pygame.Rect(paddle_ offset,playerOnePosition, line_ 
thickness, paddle size) 

paddle2 = pygame.Rect(window_width - paddle offset - line_ 
thickness, playerTwoPosition, line_thickness, paddle_size) 

ball = pygame.Rect(ballX, ballY, line_thickness, line_thickness) 


# Function to draw the arena 
def drawArena(): 

screen.fill((0,0,0)) 

# Draw outline of arena 

pygame.draw.rect(screen, white, ( 
(0,0), (window_width,window_height)), line _thickness*2) 

# Draw centre line 

pygame.draw.line(screen, white, ( 
(int(window_width/2)),0),((int(window_width/2)),window_ height), ( 
int(line_thickness/4) )) 


# Function to draw the paddles 
def drawPaddle(paddle): 
# Stop the paddle moving too low 
if paddle.bottom > window_height - line thickness: 
paddle.bottom = window_height- line_thickness 
# Stop the paddle moving too high 
elif paddle.top < line_thickness: 
paddle.top = line_thickness 
# Draws paddle 
pygame.draw.rect(screen, white, paddle) 


# Function to draw the ball 
def drawBall(ball): 
pygame.draw.rect(screen, white, ball) 


# Function to move the ball 

def moveBall(ball, ballDirX, ballDirY): 
ball.x += bal1DirXx 
ball.y += ballDirY 
return ball # returns new position 


# Function checks for collision with wall and changes ball 
direction 
def checkEdgeCollision(ball, ballDirX, ballDirY): 


if ball.top == (line_thickness) or ball.bottom == (window_ 
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height - line thickness): 
ballDirY = ballDirY * -1 
if ball.left == (line_thickness) or ball. 
right == (window_width - line_thickness): 
ballDirX = ballDirx * -1 
return ballDirX, ballDirY # return new direction 


Pong-py 





# Function checks if ball has hit paddle 
def checkHitBall(ball, paddle1, paddle2, ballDirX): 
if ballDirX == -1 and paddlei.right == ball.left and 
paddle1.top < ball.top and paddle1.bottom > ball.bottom: 
return -1 # return new direction (right) 
elif ballDirX == 1 and paddle2.left == ball.right and 
paddle2.top < ball.top and paddle2.bottom > ball.bottom: 
return -1 # return new direction (right) 
else: 
return 1 # return new direction (left) 


# Function for AI of computer player 
def artificialIntelligence(ball, ballDirX, paddle2): 
# Ball is moving away from paddle, move bat to centre 
if ballDirX == -1: 
if paddle2.centery < (window_height/2): 
paddle2.y += 1 
elif paddle2.centery > (window_height/2): 
paddle2.y -= 1 
# Ball moving towards bat, track its movement 
elif ballDirxX == 1: 
if paddle2.centery < ball.centery: 
paddle2.y += 1 
else: 
paddle2.y -=1 
return paddle2 


# Initialise the window 
screen = pygame.display.set_mode((window_width,window_height) ) 
pygame.display.set_caption('Pong') # Displays in the window 


# Draw the arena and paddles 
drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(bal1) 


# Make cursor invisible 
pygame.mouse.set_visible(@) 


# Main game runs in this loop 
while True: # infinite loop. Press Ctrl-C to quit game 
for event in pygame.event.get(): 
if event.type == QUIT: 
pygame.quit() 
sys.exit() 
# Mouse movement 
elif event.type == MOUSEMOTION: 
mousex, mousey = event.pos 
paddlel.y = mousey 


drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(ball1) 


ball = moveBall(ball, ballDirX, ballDirY) 
ballDirX, ballDirY = checkEdgeCollision( 
ball, ballDirX, ballDirY) 
bal1DirX = ballDirX * checkHitBall( 
ball, paddle1, paddle2, ballDirX) 
paddle2 = artificialIntelligence (ball, ballDirX, paddle2) 
pygame.display.update() 
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UNDERSTAND OBJECT-ORIENTED PROGRAMMING 





n the modern world, almost all of the 
code you will encounter is created 

in a style called ‘object-oriented 
programming’, or OOP for short. 

If you grew up with OOP, it is the obvious 
way to create computer programs. 

IMmOOP tie cede is ised le crear op)cets. 
These represent real-world things: a dog, a 
chair, or the wheels on a car. 

Objects contain both the variables that 
make that thing: a person’s height, age, or 
a name for example. They also contain the 
functions that object can perform: a dog can 
jump, or walk, or run; a wheel can rotate. 

OOP bundles both the variables and 
functions together. This style makes it 
Super-easy to cut and paste the code from one 
program to another. You don’t even need to cut 
and paste, in fact: you use import statements to 
get functions and the variables they need. 

With OOP, you don’t need to create an object for 
a dog: you just find one somebody else has made 
and import it to your program. 










Importing knowledge 

At the start of most programs, you’ll find a bunch of 
import statements. These are used to paste in code 
which has been created by other people. 

OOP isn’t perfect. It can be accused of overkill. “The 
problem with object-oriented languages is they’ve got 
all this implicit environment that they carry around 
with them,” says Joe Armstrong, creator of Erlang. 
“You wanted a banana but what you got was a gorilla 
holding the banana, and the entire jungle.” 

There’s also a whole bunch of decorative 
terminology surrounding OOP. You’ll encounter 
lots of strange words like ‘encapsulation’ and 
‘instantiation’. These make the concept appear much 


BEYOND 
PROCEDURE 


more complicated than it is, and can also be rather NV (A at=ranvcele mil esi moi ralam e)covele-lanlaaliave MVelUM IM o\-xellan ey] 
off-putting to newcomers. ial tate e)gexex-xol0le-| Kexeto(—¥ 

So OOP is a bit wordy and lends itself to navel- Tale ferere Ke)leCar-tial(o)al=ve Me) celexcrelUle-lmelcoyele-laniaaliavep 
gazing. Many makers, hackers, and coders struggle to you typically create all your variables at the start of a 
understand OOP, and indeed you can get a long way re)cole le= laa Mal=\a Volum aalcl\(omse)aal-maulareut(olake(-vialiice)als 
without understanding it. (these are blocks of reusable code). 

Young coders, on the other hand, are increasingly NV (em KoXe) are o\ me) gelexcve(Ule-1m e)coyele-lanlaallaveMiam=icxe)lalalcass 
introduced to programming via Scratch. fe [ie (“mre Kereye|[alen (es-\e [Wye 

Software like Scratch is included with Raspbian on OOP takes all the building blocks of procedural 
a Raspberry Pi, and it is designed specifically to teach re)cole leq la alanli are Reem \Z< la (cle) (=x ve la lei t(o)aicwm ole) essmmere)alel|t(ola icin 
students OOP stealthily. but bundles them into self-contained blocks. 

In Scratch, objects are called ‘Sprites’. They WN, Kossjmeoxoye(=\g-Hei r-rel k-0 o) cover=vo 0 le-lmsvelg/ elma tatclmianlelelae 
resemble video game characters. The idea is that objects (from modules and packages). So you're using 
children brought up on Scratch will inherently objects without even realising it. 


feel at home with objects when they migrate toa (oe) Keove)ater-) o)i-e-lc-mcelelareulal-ltaarecimr-ldmaalele(— a 
language like Python. re)coyelcclanlanliave peclalelete\e[-s-mmlaceikucel|alem eaVanalelan-la(eW/-\V/-8 
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Create a game in Scratch where players play 
dice with one another 


Stelsjelelicla 


hoYoi fo} Koi ae) alllats) 











irst, we’re going to create a game in 
Scratch. Then we’ll recreate it in Python so 
you can see how it works in both languages. 

Our dice game is based on Bunco 
(magpi.cc/2hoZNcj). It’s a popular parlour game 
played in North America. 

We’ve made the rules a little simpler. Each player 
rolls three dice and counts up the score. The player 
with the highest score wins. 

We need two players, each with their own set 
of dice. Each player then rolls the dice, looks at 
their dice, and compares them with the dice of 
the other player. 

If they have the same score, both call it a draw. 

If a player spots that their total is higher than the 
other person’s, they shout out “I win!”’. 

This game introduces you to the concept 
of local variables. Each sprite has three local 
variables: their own set of dice. They can also 
look at the variables (or dice) that are local to 
other sprites. 

The opposite of a local variable is a global 
variable. This is as if both players rolled a single set 
of dice and shared the result. They’d always draw. 

Scratch works slightly differently to Python. 

In Scratch, you create one sprite and then clone 
(duplicate) it to create a second sprite. In Python, 
you create a blueprint for your sprites (known as 
a ‘class’) and then stamp out two player objects. 
We'll come to Python in a bit. 

Let’s create the dice game in Scratch first... 
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Cortrol 
Some 2s Seven 


Operators 


>STEP-O1 

Scratch 

Open the web browser and visit scratch.mit.edu to 
open Scratch 2.0. We need the clone features from 
2.0, so don’t use the Scratch 1.4 app. Log in (or create 
an account if you’re new to Scratch). Create a new 
project and you’ll see a single Scratch Cat sprite on the 
screen. Click the ‘i’ symbol next to the sprite in the 
bottom-left. Change its name to Player1. 


>STEP-02 


Three dice 

Click on Data and then Make a Variable. Enter dice1 
in the Variable name field and select ‘For this sprite 
only’. Click OK and dice1 appears in the blocks 
palette. Repeat the process to create dice2 and dice3. 
Finally, create another variable called total. 
Remember to choose ‘For this sprite only’ for all 
Meee Gee ainGl ve ialll, 
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Bunco on Scratch « 4 


>STEP-05 








SUTIN 0. seton/reoundh nh ataterstouarsaveneanceeadhes ear 8 @ : 
ta Oa a. Compare scores 
eee Motion Jeverts ~~ ® ) 3 ) 
ES com Ry We’ve only got one sprite so far. But we’re about to 
= Fares rs add another and compare one sprite’s total with the 
=A en other. Choose the Sensing selection of blocks and 
Ge o> look for one marked x-position of Player1. Change 


‘x-position’ to total. Drag the block into the correct 
side of the greater-than block. 


© Foralsprtes @ For thes sprte only 










yl ™= clicked ws 


FIOy 0 

= | =) 4 

aE bet diced 
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Throw the dice pick random @ to @ 
Click on Events and drag awhen green flag clicked 


| | 
block to the scripts area. Below this you need to 


add three set diceN to pick random 1 to 6 blocks. — “total for @} secs 
Below these blocks, add set total to dice1 + dice2 
ams Kol MQUOLem olarc\e mnoKebu-lcxe) ele @ em @ Mp) lelel -aletsyiele 
another to add up three blocks. 


4 
we 
iced : 
Bice El ok mim O&O) 
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iced to. pick random @ to @ 


clicked 
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>STEP-06 
Player 2 

Our Player 1 is ready. Now we’re going to clone the sprite 
to create a Player 2. Right-click the sprite and choose 
Duplicate. The new cat sprite will be automatically called 
‘Player2’. Click on Player1 in the Sprites window. Change 
the total of Player1 block to total of Player2 (as shown 
below). Now Player1 compares their total to Player2 (and 
Player2 is comparing theirs to Player1). Click the green 
flag to run the program and see which player wins. 















>STEP-04 









Speak 7's tenco.on Serstch, x \ ih : — a 
Now drag a say for block and attach it to the end of no a EY 
the code. Change it to say total for 1 secs. Below Be) roonatasey ers E 
that, drag an if block. Inside, adda [] > [] (greater- 
than) block. Drag the total variable to the left side of 
the greater-than block. Drag a say block inside the if OY 
block and change ‘Hello!’ to ‘I win’. ee KR 
OD wey ae 


New sprite: ¢/aa 


A= licked Gwe 


¥ pick random @} tc @ Fe 
. 0 
Kes? te. pick random @ to @ | 











Ai av=mexe)aver=) 0) mo) m-cere) ol-m -Mlan] ele)ars\aim|ake)e)(-celmrelai-1alx-1el e)celele-\aalaaliace mm lamecercs| cola Mal ms 


JoRsj[aa)e)Comaarelmvelemaals\Va are] m=) )aN ale) s(e-mi am 0 mele m@ Avon o)k-\V(=)6-K-r-\elaMal=\omsal=llmenuial 
dice1, dice2, and dice3 variables, plus a total variable. These variables are local in 
scope. When Player1 announces total, it’s their total. If both sprites accessed the 
oto] aatom ce) r= lem | MV elu | (oll ol-Me|lo)er-\Mlamsyeve)el-Ma\/-lai-10](= Ml ake)e)(-reincw-|g-m loler- ml a ere) 0-3 
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CREATE BUNCO 
IN PYTHON 


CLASS 
AND INSTANCE 


One of the biggest differences between creating sprites in Scratch and 
fo) 0) (=Teak=M aM maVA" acelau om tal=lMV(el0Kelg=1-|X-M-|aKe)o)(-cei mb (<i | ale r= Koi t= 1S Mal smevele (== (ed ks 
reise= Wm ellU(=) e/g lal mice) iatoKe)e)(-101 

In Scratch, you create a sprite and then duplicate it. The second sprite has 
the same functions as the first. It also has its own set of variables. 

TaMeaYatalolancs lave meltal-1m e)coyeleclaniaaliacemtslaveletale(=-)mmnallaveomcelg @svelaal=au/iarels 
rollix=ia=1altNam (ole me(olabmeic-r-l-e-lame)e)(=1e1mel|c=reit Val |asciccr=(e Melber coylKoe-Beliu(-jelalais 
for the objects. This blueprint is known as the ‘class’ Don't think of a school, 
though. Class here means a category of similar items. It's rather like a ‘Class M 
foltclavoimlameltl@m ics em areluceaMeliix= ical mm ual=iom-lcoe-10@ =t-latabs liom oltcla(ciice 

Once you've created your class, you use it to create objects. 

These are known as ‘instances’ or ‘object instances’ They all share 
1/aalitclay eae) el=iau(os-Wam Malonvare|lmarc\omdalomot-laalomve-l alle) (os-m-lale mab lavend(e) ars 

'Cor=} 1K=Yo Ml aal=14 a vole tw rm laWsyoi ¢-1 Koi a Wm (= Moi g=y-1K=Melalomo ol gikcm-lalommal-lamelelelilersik= 
it (to get two sprites). In Python, we create one class definition. We then 
use this to create two object instances. 
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Recreate our game of Bunco in Python 


ur basic version of Bunco runs just fine in 
Scratch. Now we’re going to recreate it in 
Python. The translation will help us get a good 
understanding of how objects work. 

First, think about how we could make the 
game procedurally. 

There is a module called random that we can import 
to create random numbers. So we’d need to import 
that. Then we could create a list for each player. 

And use the randint function to add three random 
numbers between one and Six. 

We could then use an if else block with the sum() 
function to add up each player’s numbers. The player 
with the highest score wins. 

Type out the code from bunco_procedural.py to test 
the program. 

There are two problems with this procedural. 
Bunco is a much more complex game in real life. 

It is played in six rounds, and players score 21 points 
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if they roll all three dice that match the number of 
the round (three 1s in round 1, or three 2s in round 2, 


and so on). That’s known as rolling a ‘bunco’. 


We’re not going to create all that complexity here. 
But we are going to add extra types of player. Cheats! 
One scoundrel has loaded dice; the other rapscallion 


swaps out one die for a Six. 


We’re then going to play thousands of games and 


see who wins. 
This complexity would be extremely difficult in 


procedural programming. It requires us to rethink our 


approach to Bunco. And OOP is the answer. 


OOPs upside your head 





Instead of creating a list of variables for each player at 
the start, we’re going to create a class called Player. 
The code in bunco_oop.py represents a dice player. 


We then use it to create two players (see ‘Class 
and Instance’). 


As with our procedural code, we start by importing 


the randint module. 
Now we define our player objects. To do this, 
we create aclass definition. It looks like this: 


class Player: 


Inside the class definition is indented code that 
describes the player object. 


Notice that the class name is capitalised and, unlike 


function definitions, there are no parentheses. 


The first thing we need to add is a list to contain the 
dice. Normally this would be just dice = []. But if we 


wrote it like this: 


class Player: 
dice = [] 


...we’d have a problem. This code is equivalent to 

choosing ‘For all sprites’ in Scratch. Every player 

created using this code would share a single set of 
dice and get the same results. We want to use the 

equivalent of ‘For this sprite only’. 


To ensure that all our players have their own set of 
dice, we need to wrap the dice = [] list inside a quirky 


function called __init_ (). 
It looks like this: 


class Player: 
def init _ (self): 
self.dice = [] 


The __init__() function runs when you use a class 


to create an object. 
This is known as a ‘constructor’ or ‘initialiser’. 
Later on, when we use this Player class to create 
player objects, the ___init__() code runs each time 
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Ianguag 
bunco_procedural.py iss 


DOWNLOAD: 
magpi.cc/ 2jxE6WJ 


import random 


[] 
[] 


player1 dice 
player2_ dice 


for i in range(3): 
player1_ dice.append(random.randint(1,6)) 
player2_dice.append(random.randint(1,6)) 


print("Player 1 rolled" + str(playeri1_dice) ) 
print("Player 2 rolled" + str(player2_dice) ) 


if sum(player1 dice) == sum(player2_ dice): 
print("Draw" ) 

elif sum(player1_dice) > sum(player2_ dice): 
print("Player 1 wins") 

else: 
print("Player 2 wins") 








bunco_ocop.py 


from random import randint 


class Player: 
def init (self): 
self.dice = [] 


def roll(self): 
self.dice = [] # clears current dice 
for i in range(3): 
self.dice.append(randint(1,6) ) 


def get dice(self): 
return self.dice 


player1 = Player() 
player2 = Player() 


playeri1.roll() 
player2.roll() 


print("Player 1 rolled" + str(player1.get_dice())) 
print("Player 2 rolled" + str(player2.get_dice())) 


if sum(player1.get_dice()) == sum(player2.get_dice()): 
print("Draw!") 

elif sum(player1.get dice()) > sum(player2.get_dice()): 
print( "Player 1 wins!") 

else: 
print("Player 2 wins!") 
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automatically. It creates a separate set of dice for each of An object’s functions are called ‘methods’, but they 


our players. are created in the same way. 

The ‘self’ bit also needs explaining. Variables, like There are lots of different types of methods, and you 
our dice = [] list are normally disposed of when a can create whatever you like, but common ones are 
function ends (or is returned). called ‘setters’ and ‘getters’. 

So if we just put dice = [], the list would be created Our roll method is a ‘setter’. It sets the dice list to 
by __init__(), then immediately vanish. three random numbers. 

Python gets around this problem using the keyword What do you think a ‘getter’ does? That’s right. It 
‘self’. You put ‘self’ inside the parentheses of the gets the variables inside the object and returns them. 
__init_ (): We have just the one getter: 

def init (self) def get _dice(self): 


return self.dice 
Then we use self, followed by a dot, to store the 


variable in this version of the object. Getters and setters seem a bit odd at first. After 
all, you could just reach into an object and access 
self.dice = [] the variables. 
Well, you could, at least in Python, but this is 
You then use self. in functions when you want to considered a bad thing to do. One of the points of OOP 
access or change a variable, by writing self insidethe _ is that objects contain their variables and keep them 
parentheses of the function. Like this: safe from other objects. So you don’t just reach inside 
an object and access variables. 
def roll(self): Instead, you create methods (functions) that set the 
variables and get them. Then you use these methods 
The concept can be mind-boggling (it’s passing a to set and get variables. 
version of itself into itself). So focus on the practical Now we’ ve created our class definition, we can use it 
steps rather than the esoteric theory of how it works: to create objects. 
e Put aspecial function at the start of a class called 
e Put the variables you want to use inside init. You create objects just as you would a variable. You 
use the assigns operator (=). We’re going to create two 
° Create the variables with self., like self.name dice players: 
or self.age or self.dice = []. 
playeri1 = Player() 
° Place self inside the parentheses of functions that player2 = Player() 


need to access the variables. 
Note that player1 and player2 are not called 


° Use self. and the name of the variable inside ‘variables’. They are called ‘object instances’. 
the function to use it. We access the object instance’s methods using dot 
notation. That is where you use the name of the object 
Got that? Don’t worry too much if it seems weird. instance, followed by a dot, then the name of the 
That’s the hardest part and it will get easier with practice. method you want to use. 
Now we’ ve got our dice list sorted, what about the We created a method, get_dice(), that returns 
other functions? the dice stored. We would access this method using 


: dot notation, such as playeri1.get_dice(). 
Methods in the madness First, we use the roll method to get each player 





object to roll its dice: 


Now that our class has a list for the dice, we need 


to roll the dice. For that, we’ll create a more regular player1.rol1l1() 
function definition. player2.rol1l1() 
def roll(self): The rest of our bunco_oop.py program is really 
dice = [] # clears any current dice very similar to bunco_procedural.py. The difference 
for i in range(3): is that here we use the .get_dice() method in 
self .dice.append(randint(1,6) ) place of sum(). 
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Inheritance cheats 





We’ve already mentioned that one advantage of OOP 
is that we can create hundreds or thousands of players 
with their own set of variables. 

There’s little point in our program as it is, as 
the players are all using the same dice and have the 
same chance of winning. What would happen if we 
introduced some cheats? 

We’re going to create a cheat who swaps out one die 
for a six. The blighter. 

Our cheat is not alone. We have another one who 
uses three loaded dice. They always roll one higher 
(unless they’re already a six). 

Both cheats would beat a regular player over a few 
hundred games. But which of the cheats would win 
against the other? 

It’s pretty close. To find out the answer, we’ll 
need to run a Simulation that plays hundreds of 
thousands of games. 

We’re going to create our cheats using a technique 
called inheritance. This technique is where you create 


But which cheat 
would win against 
the other? 


a class that takes on all the properties (instance 
variables and methods) of another class. It also adds 
a few of its own. 

Think of a child inheriting its parents’ features. 

It might get its dad’s big nose but grow knobbly knees 
all by itself. 

Our cheats will inherit the same dice and roll 
functions as the parent, but they will have cheat 
functions all of their own. 

Our bunco_module.py program defines the 
Player() class and two children: 


class Player: 
class Cheat_Swapper(Player): 
class Cheat_Loaded_Dice(Player): 


Objects that inherit from a parent are defined using 
the same class keyword. 

However, the name of the parent is placed inside 
parentheses of the child. 

Our two cheats inherit all the variables and methods 
(functions) from the parent. So they already have a 
dice list and rol1() and get_dice() methods. 

We now give each cheat an additional method, 
called cheat. This is implemented in a different way 
for each type of cheat. 
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| bunco_module.py 


from random import randint 


class Player: 
def init (self): 
self.dice = [] 


def roll(self): 
self.dice = [] # clears current dice 
for i in range(3): 
self.dice.append(randint(1,6)) 


def get _dice(self): 
return self.dice 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


class Cheat_Loaded Dice(Player): 
def cheat(self): 
i= 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 





















































bunco _single_test.py 


from bunco_ module import Player 
from bunco_ module import Cheat_Swapper 
from bunco module import Cheat Loaded Dice 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded Dice() 


cheater1.roll() 
cheater2.roll() 


cheater1.cheat() 
cheater2.cheat() 


print("Cheater 1 rolled" + str(cheater1.get dice())) 
print("Cheater 2 rolled" + str(cheater2.get_dice())) 


if sum(cheater1.get_ dice()) == sum(cheater2.get_dice()): 
print("Draw!") 


elif sum(cheater1.get_dice()) > sum(cheater2.get_ dice()): 
print("Cheater 1 wins!") 


else: 
print("Cheater 2 wins!") 
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The Cheat_Swapper class definition has a relatively 
straightforward cheat method: 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


Cheat_Swapper’s cheat method finds the last item 
in the dice list and sets it to 6. 

Our Cheat_Loaded_Dice class definition has a 
Slightly more complicated cheat method: 


class Cheat_Loaded_ Dice(Player): 
def cheat(self): 
i= 0 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 


This method iterates through the dice in the list, 
checking whether each die is lower than six. If so, it 
increases its value by one. 

Make sure that you create the code in 
bunco_module.py and save it with the same name. 
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Notice that this code doesn’t have any procedural 
programming below it. This is because we’ re going to 
import it (so you can see what happens when you use 
import in your Python programs). 

Now we will create the code that uses these 
objects in a separate file. Enter the code from the 
bunco_single_test.py listing and make sure you save 
it in the same directory as bunco_module.py. 

The first line imports the Player class definitions 
from our bunco_module.py. 


from bunco_module import Player 


Extra points to you if you spotted that 
bunco_module is listed without the ‘.py’ file 
extension. This is how you import code from other 
files into your program. 

The import Player line pastes in the class Player 
code from bunco_module.py. It’s as if you had 
included that code in your program. 

Compare this line to the from random import 
randint code at the start of bunco_module.py. The 
idea is the same. 

We import the other two class definitions 
we created: 
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from bunco_module import Cheat_Swapper 
from bunco_ module import Cheat_Loaded Dice 


The rest of the bunco_single_test.py code creates 
the same game as our earlier bunco_oop.py program. 

Now we create two object instances using the 
Cheat_Swapper and Cheat_Loaded_ Dice definitions 
we imported from bunco_module: 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded_Dice() 


We then use the roll1() method. Notice that 
neither Cheat_Swapper() or Cheat_Loaded_Dice() 
has aroll method definition. This is a function they 
both inherit from their parent class, Player(): 


cheater1.roll1() 
cheater2.rol1() 


Next we call the cheat () method from each 
object instance: 


cheater1.cheat() 
cheater2.cheat() 


Although each object has a method called cheat(), 
the objects have different implementations. So 
cheater1 changes the last die toa 6, and cheater2 
increases each individual die’s value by one. 

Run the program by pressing F5 and see which of 
the players wins. Run it again and you’! get different 
results. Keep running the program and you’ II find it’s 
a pretty close call. 

Look inside the folder containing the code 
and you’ ll see a new file has appeared called 
bunco_module.pyc. This is a ‘compiled file’ 
and is created the first time you run a program 
that imports code. You don’t usually see compiled 
files because you import code tucked away inside 
Python on your computer. Don’t worry about it. 
You can’t open and make sense of it in a text editor. 
Delete it if you wish. It’ll be recreated when you use 
bunco_module.py in our final program. You can just 
ignore it for now. 

To discover which of the two cheats has the edge, we 
need to run a simulation. We need to play hundreds 
of thousands of games and keep track of who wins 
the games. 

Our final program, bunco_simulation.py, 
does just that. This program brings together 
everything we’ve learned about OOP. The code in 
bunco_simulation.py creates two cheats and plays 
100,000 games. It imports class definitions from our 
bunco_module.py program (so make sure you save it 
in the same folder). 
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bunco_simulation.py 


from bunco_module import * 


Swapper = Cheat_Swapper() 
loaded dice = Cheat _Loaded_ Dice() 


Swapper score = @ 
loaded dice score = @ 


number_of_games = 100000 
game number = @ 


print( "Simulation running") 

print ("====s==s=====s=====") 

while game_number < number_of_games: 
Swapper.roll() 
loaded_dice.roll() 


Swapper. cheat() 
loaded _dice.cheat() 


#Remove # before print statements to see simulation running 
#Simulation takes approximately one hour to run with print 
#statements or ten seconds with print statements 
#commented out 


#print( "Cheater 1 rolled" + str(swapper.get_dice())) 
#print( "Cheater 2 rolled" + str(loaded dice.get dice())) 


if sum(swapper.get_dice()) == sum(loaded dice.get_ dice()): 
#print( "Draw! ") 
pass 


elif sum(swapper.get dice()) > sum(loaded_dice.get dice()): 
#print("Dice swapper wins!") 
Swapper _score+= 1 
else: 
#print( "Loaded dice wins!") 
loaded dice score += 1 


game_number += 1 


print( "Simulation complete") 


aipeil(g) (4 eee aes eee ") 
print("Final scores") 
print(" eg eg yer ay ee ) 


print( "Swapper won: + str(Sswapper_score) ) 
print( "Loaded dice won: " + str(loaded_dice_ score)) 


if swapper_score == loaded_dice_ score: 
print("Game was drawn") 

elif swapper_score > loaded dice score: 
print("Swapper won most games") 

else: 
print("Loaded dice won most games") 
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Use Git version control software to work on your own code 
and contribute to open-source projects. By Marc Scott 


Ss ® C3 Bi pi@respbenype ~/sn $ 





pi@raspberrypi: ~/snitch-sniffer 


pi@ra 





spberrypi: mkdir snitch-sniffer 
pi@raspberrypi: cd snitch-sniffer/ 
pi@raspberrypi: nano README.md 
pi@raspberrypi: ls 


README .md 
pi@raspberryp1l: git init 
[Initialized empty Git repository in /home/pi/snitch-sniffer/ 


; 


README .md 
pi@raspberrypi: 
description 


config HEAD 


pi@raspberryp1l: 





pi@raspberrypi; ~/snitch-sniffer 


File: README.md 


multiple long-range ultrasc 
flying in three-dimensional 


speed, and trajectory througt 








& a) (> [=] & FS pi@raspberypi ~/sn. ¥ Tl 4) ° | 13:43 


pi@raspberrypi: ~/snitch-sniffer 





pi@raspberryp1: git commit -am ‘finish find func 
imeem 
[master b1e548e] finish find function 
1 file changed, 1 insertion(+) 
pi@raspberryp1: 


Edit Tabs Help 


(= 





pi@raspberryp1l: git commit -am ‘add README.md' 
[master (root-commit) f188dd9] add README.md 

1 file changed, 1 insertion(+) 

create mode 100644 README .md 
pi@raspberryp1l: 









AM obtsmeroyonbaebincw-t 0 lmnal-melak-balcxctcmrcolematchVcment-\e(-mnemaal= 
directory to the Git repo, and adds a message saying 


what you did. The message can be anything really, but 


it’s best to keep it fairly short yet descriptive of what 
you changed. 


Time travel 


Now that you have set up your repo, it’s time to get on 


with the project. Create two new files and store them in 


your snitch-sniffer directory: 


touch snitch-sniffer.py quidditch-rules. json 


Typing 1s reveals those files. 
README.md quidditch-rules.json snitch- 
sniffer. py 


The new files need to be added to the Git repo and 
then committed. 


git add --all 


git commit -am ‘add json rules and python 
'o) ae}: are] 


Carry on working on your code (enter nano 
snitch-sniffer.py and add some dummy code). 
Every time you make a change to the file, perform 
a new commit. 


git commit -am ‘finish find function' 


Now imagine that you’ve made a horrible 
mistake. You’ve been working for a while, 
and you’ve deleted your find_snitch() function, 
and then performed a commit. With Git, it’s easy 
to go back in time and restore an earlier version 
of any of your files. Let’s first look at the commit 
history of the file. 


git log snitch-sniffer.py 
This produces something like this: 

commit 
12c4c693e95438ceadcf3f4fb39c83celade712Ff 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:27:17 2017 +0000 

delete find function 
commit 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
Author: Harry Potter <h.potter@hogwarts.prog> 


Date: ST at Me | =| a A 2 ee BAe 2) 2) 2) 2) 


finish find function 
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commit 8d1614c7251fbd16626aca83ccO8d65fc79lblaa 


commit 4e8b/e/fT8/ddc61d/8f02FcS5de1c8d0/1/46d2db 


commit f55/ce90caafcba&8ab361e992939a152e625dad2e 


commit 
127545c19794b5 fe869dd22d0cf57bf8820c5794 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:20:18 2017 +0000 


add json rules and python program 


You can see that the last commit (the one at the 
top) was where the function was deleted. Luckily, 
the commit message has made it easy to see what was 
done, which is why commit messages are important. 
However, typing: 


git log -p snitch-sniffer.py 


...would have shown the changed contents of the 

file if the commit message wasn’t clear enough. 
You can now get back the version of the file 

from the previous commit. The long string of 

characters after the word ‘commit’ is called a 

hash, and is used by Git to keep track of files. In 

this case, the commit that needs to be restored is 

5£d772a292c019a7cf3012b1156685280d4a7d2d. 

Typing the following will get the file back to the way 

it was: 


git checkout 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
snitch-sniffer. py 


The file will be restored, and you can now commit 
id abicmel ar-balexon 


git commit -am ‘restore find function' 


Making major changes 
Imagine you’re talking to someone about your 
amazing project, and they have a cool idea for some 


Misl-n@lineclest-jeeeaaae 






You can always check 
the current status of 
ole lag) ele) 





















changes you could make to improve it. They suggest 
using lidar rather than ultrasonic sensors. The 
changes are quite large, though, and you’re worried 
that if you make them, you might break the project. 
You could make a copy of the directory and start 
working on this copy, but to keep using Git, you’d 
have to make an entirely new repo. This could all 
get quite confusing. Luckily, Git has a feature called 
branches. Using a branch allows you to make copies 
without losing or altering your original work. 


First, you can have a look at your repo’s current status. 


git status 
This should show something like this: 


On branch master 
nothing to commit, working directory clean 


Now you can make a new branch in the repo, which 
lets you work on your amazing new adaptation. 


git checkout -b lidar-version 
Now git status will show you something like this: 
On branch lidar-version 


nothing to commit, working directory clean 


This tells you that you are on the lidar-version branch. 


To view all the branches in your repo, you can type git 
branch, which will show something like this: 


* lidar-version 
master 


You can now work on the lidar-version branch without 
altering your master branch. If you try out the new 
approach and find it doesn’t work, you can simply delete 
the branch using git branch -D lidar-version. 
However, if it all works well, you can merge the 
branch back into your master branch. First, you’ll 
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need to make sure all your changes are committed and 
then switch back to the master branch. 


git checkout master 


Then you can merge the version into the master 
branch: 


git merge lidar-version 


Warning: you can cause problems with a merge if 
you're working on two branches at the same time, 
as Git won’t know which changes are the ones you 
want to keep. For this reason, it’s best to work on one 
branch at a time. 


Setting up a Git service 

Now that you know how to do the basics in Git, it is 
time to learn how to use it to its full potential: sharing 
your work and collaborating with others. 

There are lots of services that will host your Git repo 
for you, free of charge. GitLab is one such service, and 
BitBucket is another. In this resource, you are going 
to be using GitHub (github.com), which is one of the 
more popular services. 

The first thing to do is to register for an account on 
GitHub: just choose the free plan. Now that you have 
an account, you can create a snitch-sniffer repo on 
GitHub. Click the New Repository button to the right 
of Your Repositories. Give the repo a name (enter 
snitch-sniffer in the Repository Name field, anda 
short description, such as ‘3D tracking of objects in 
space’ and click Create Repository). This will bring 
up a page of instructions. As you already have a repo 
ready to push to GitHub, all you need to do is make 
sure you are in your project directory in a Terminal 
window, and type: 


git remote add origin https://github.com/ 
harrypotter/scratch-sniffer. git 


...and then: 





iM C=yaellavem olbi em dal-movat-lale(- MV (ol Marc\V(-Maarc(o(oM[alcomiolelmaat-\-i-) mo) e-laleag) 


raspberrypi.org/magpi 





/ 0 CeateaNewRe « 


€ 


CS | @ Secure | tips github cominew 


Create a new repository 


A repository contains al the files for your project, inchating the revision history 


Owner Repositary name 


a 


Great repostory names are short and memoratie. Need napration? sow about synwnetrk al 
auMar 


Description joptiona® 
* | Public 
Anyone (an coe tres rapostory You choose whe can commt 
os) & Private 
— 1 CNISCE AND CEN SG8 and COMWNE Oe ChE TepoET Ory 


\) intiaize this repository with « RLAOME 
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The snitch-sniffer 
repo, showing 
branches, commits, 
and other information 


Cc | @ Secure | https //github.com/lucyhattersiey/scratch-snilfer 


& lucyhattersley / scratch-sniffer wStar 0 8 YFork 0 


<> Code Dissues 0 I) Pull requests © Pi Projects © 


3d tracking of objects in space 
Add topks 


@ 6 commits © 0 releases 42 1 contrutor 


Srenck: master> New pull request Create new file Upload files Find file | Clone or download ~ | 


EB tucyhatterstey Added lidar function Latest coment 93a6e001 2 days ago 
&) README.md add README md 2 days ago 
& quiddtch-rules json add json rules and python program 2 days ago 


& snitch-snitterpy Added lidar function 2 days ago 


@ README,md 


The Golden Snitch Sniffer. 


This is 4 project that uses mutkiple long-range ultrasonic sensors to find and track an object flying in three- 
dimensional space. It displays the object’s coordinates, speed, and trajectory through 6 VR headset. 


© 2017 Gittub. inc. rms Privacy Security Status Melp Contact Gitiu® Art Training Shop Blog About 


ithub.com/lucyhattersiey/scratch-sniffer/branches 


Practise coding for the Sense HAT hardware using the Sense HAT 
emulator built into Raspbian 
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Eile Edit Format Run Options Windows Help 
SenseHat 


sense = SenseHat() 












green = (0,255.0) 
white * (255.255.255) 





humidity = sense.humidity 
humidity_value = 64 * humidity / 100 
pixels = [green i < hmidity_value 
sense. set_pixels(pixels) 


white i range(64)} 





















Orientation 


-” nn* 
0.0 


Screen Temperature ressure Humidity 


Yaw 





Onentation scal 


7 Environment sensors 






Simulate 
Li ~ inertial measurement unit 





Screen updates | 60 












humidity py 


sense emu SenseHat 


sense = SenseHat() 
green 
white 


humidity = sense.humidity 
humidity_value = 64 * humidity / 10@ 
pixels [green i < humidity_value 

white 
sense.set pixels(pixels) 





colorsys 
tum sleep 
sense_emu 





0.27. 0.34, 0,41 
0.35. 0.42, 0.49 
0.42. 0.50, 0.37 
0.%. 0.57, 0.66 
0.58. 0.65, 0.72 
0.44. 6.73. 0.80 
0.73. 0,80, 0.87 
0.81. 0.88, 0.95 











hues = ((h + 





0.01) & 1.6 h Pes) 


pixels © [Nsv_to_rgp(hm. 1.0, 1.0) h twes) 





pixels = [{scale(r). scale(g). scale(b)) 


hat .set_pirels(picels) 
sleep(0.04) 
















i range(64) | 
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file £dk Format Aun Options Windows Help 


colorsys hsv_to_rgb 
time sleep 
sense_hat] Sensenat 

twee « [ 
0.00, 0.00, 0.06. 0.13, 0.20, 0.27. 0.34, 0 
6.00, 0.06, 0.13, 0.21, 0.28, 0.35, 0.42, 0 
0.07. 0.14, 0.21. 0.28. 0.35. 0.42. 0.50. 0 
0.15. 0.22. 0.279. 0.36, 0.43, 0.50, 0.57, 0 
0.22. 0.29. 0.36. 0.44. 0.51. 0.58. 0.65, 0. 
0.20, 0.37, 0.44, 0.51, 0.58, 0.66, 0.72, 0. 
0.38. 0.45, 0.52. 0.59, 0.66. 0.73. 0.80, 9. 
0.45, 0.52, 0.60, 0.67, 0.74, 0.81. 0.88, 0. 
} 

hat = SenseHat( > 
scale (v): 

t(v * 255) 

hues = [(h + 0.01) % 1.0 h hues] 
pixels = [hsv_to_rgb(h. 1.0. 1.0) h 


pixels = ((scale(r). scale(g). scale(b)) 


hat.set_pixels(pixels) 
sleep(0.04) 


hues) 
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Petite, efficient, and well connected. 
Meet the latest member of the Raspberry Pi family 
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Up close with the technology packed onto a Pi Zero W board 
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We chat with Roger Thornton, principal hardware engineer at the Raspberry Pi Foundation 


01. Ground plane 

This free space is used to 
interact with the radio waves. 
They resonate in this cavity at 
UO tal=male|almaccre (e(- elena 


02. Capacitors 

At the lower part of the 

fe |celUlalel o)k-lal=esiim ale) 

ors) oya\oi |e) s-4 Malors(= Mors) o)Ul a=) 
talomcclellomsielal= le 





a raspberrypi.org/magpi 





@oeeoeoeonadneenaeoeneoenaee@e@} 08 @ 20 © © 
Cee ee ee ee ee er Oe Oe Om Oe) 
@ ®ospberry Pi Zero WV1.1 FEC ED: 2ABCB-RPIOW » 
a ve I€: 20953-RP10W 
e © Raspberry Pi 2016 4S STM- 5w94V-0 @ 
| E207844 =") i, 


7 


Homi, 3 


Uses antenna technology 


0) OOM) licensed from Proant AB @ ry 





The white text is added to the PCB using a silk-screen technique. 
These markings are used to provide information and branding for the board 


The intelligent layout enables all the 
circuitry to be placed on one side of 
the PCB, keeping the cost down 
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A whole new way to hold your Raspberry Pi 
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Camera cover 
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Five great project ideas for you to build with your new Pi Zero W 


Use a speaker 
and microphone to 
turn your Pi Zero W 

into a hands-free 
Amazon Alexa Echo 


S 








Zane tew 











, 
_ SUBSCRIBE TODAY AND RECEIVE 


Yuudouug 

160S115 

Rick “=, 
D-Carp 
tril323 


pat) 
5 


<a 


oe oe a 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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Free Camera Module connector 
Free USB and HDMI converter cables 
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Free delivery to your door 
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The world’s favourite single-board computer, the Raspberry Pi is packed 
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